FW Gallery – Documentation

Image Upload Problems

If images fail to upload or process correctly in FW Gallery, the cause is usually a server configuration issue rather than a problem with the extension itself. Work through the common causes below to identify and resolve the issue.

PHP File Size Limits

PHP enforces limits on how large an uploaded file can be. If your images exceed these limits, uploads will silently fail or produce an error. Two PHP settings control this:

• upload_max_filesize — the maximum size of a single uploaded file
• post_max_size — the maximum size of the entire form submission, which must be larger than upload_max_filesize

You can raise these limits by editing your php.ini file or by adding override directives to your .htaccess file in your site root. Contact your hosting provider if you do not have direct access to these files.

Image Processing Library Not Installed

FW Gallery requires a server-side image processing library to resize and handle uploaded images. Either GD or Imagick must be installed and enabled in your PHP environment. If neither is available, image processing will fail after upload.

Check with your hosting provider or system administrator to confirm that GD or Imagick is active. Most managed hosting plans include GD by default, but Imagick may need to be enabled separately.

Folder Write Permissions

The folder where FW Gallery stores uploaded images must be writable by the web server. If permissions are too restrictive, the server cannot save the uploaded file to disk.

• Check that the relevant uploads directory has the correct permissions set (typically 755 or 775 depending on your server configuration)
• Verify that the directory is owned by or accessible to the user account your web server runs under
• Use your hosting control panel or an FTP client to review and adjust permissions if needed

File Type Not Permitted

If a specific image format is being rejected, your server or CMS configuration may be blocking that file type. Review the allowed file types in your site's media or upload settings and ensure the formats you are uploading (such as JPEG, PNG, or WebP) are included on the permitted list.

Troubleshooting Steps

1. Check your server's PHP error log for messages related to the failed upload — this usually identifies the cause directly.
2. Confirm your upload_max_filesize and post_max_size values are large enough for the images you are uploading.
3. Verify that GD or Imagick is listed as an active PHP extension.
4. Check folder permissions on your uploads directory and correct them if the directory is not writable.
5. Test with a smaller image file to determine whether file size is the limiting factor.
6. If the problem affects only certain file formats, review your permitted file type settings.

If you have confirmed all of the above are correctly configured and uploads still fail, gather the PHP error log output and contact Fastw3b support with those details.