Image upload problems usually come from unsupported files, too many images, interrupted uploads, unsaved changes, missing permissions, or switching away before pending image changes are saved.

Image upload fails

• Check your internet connection and try the upload again.
• Zwyn currently supports JPEG, PNG, GIF, and WebP images.
• Each image can be up to 5 MB. If a file is larger, compress or resize it before uploading.
• For profile images, make sure you are signed in as the tag owner.
• If the upload fails unexpectedly, reload the page and try again with the same image.

The image does not appear

• Check whether the image is still pending. Pending image changes may not appear publicly until the profile or entry is saved.
• Make sure you saved the profile or entry after adding the image.
• Reload the page after saving to confirm the stored image is shown.
• Check access settings if other people cannot see images that are visible to you as the owner.
• Check the tag state. Disabled tags may not behave like active public tags.

Too many images

• Image blocks and image fields allow up to 5 images by default.
• Some image blocks or schema fields can be configured with a different image limit, up to a maximum of 10 images.
• The limit applies to the individual image block or image field, not to all images on the tag combined.
• Remove images you no longer need before adding more to a block or field that has reached its limit.
• If you only want a better version of an existing image, remove the old image and upload the replacement.
• Use image order and hero image settings to keep the most important profile images easy to find.

Unsupported file type

• Only upload image files in fields or blocks designed for images.
• Renaming a non-image file does not make it a valid image.
• If an image format is rejected, export or convert it to a common image format and try again.
• For documents or receipts, use a screenshot or photo if the field expects an image.

Profile image changes are not saved

• Make sure the profile is in edit mode before changing image blocks.
• Image block changes can stay pending until the profile is saved.
• If you use Revert or Cancel before saving, unsaved image changes can be discarded.
• If image order looks wrong, move the images again and save the profile.
• If the wrong image appears first, check the hero or main image setting for that image block.

Entry image changes are not saved

• The entry schema must contain an image field before images can be attached to entries.
• Use the media panel for image fields when creating or editing an entry.
• Save the entry after selecting, removing, or changing images.
• Fix required fields or validation messages before saving entry image changes.