Troubleshooting

Images and media issues

Fix awkward crops, blurry product cards, video playback, mobile media, and unreadable overlay text by checking source media before changing section styling.

ImagesVideoMobile crops

Fix By Symptom

What you see

Hero, campaign, or product images crop awkwardly

Likely cause

The subject is too close to the image edge, or desktop media is being reused for a narrow mobile crop.

Check in Shopify

Confirm the uploaded image has enough space around the product, model, face, or important detail.

Check in SAISON

Set image ratio, height mode, focal point, mobile crop, and mobile-specific media where the section provides it.

When to contact support

Send the original image, affected URL, and desktop/mobile screenshots.

What you see

Images look blurry or pixelated

Likely cause

The source media is too small, compressed, or being stretched into a larger layout than it can support.

Check in Shopify

Upload a larger original image and check Shopify file compression only after the source file is adequate.

Check in SAISON

Use a layout with a smaller crop area or choose a more suitable image ratio for the section.

When to contact support

Send the image dimensions and the section where it appears blurry.

What you see

Product cards look uneven across a collection

Likely cause

Product images have mixed framing, aspect ratios, or gallery images that do not match the first image.

Check in Shopify

Review several products in the collection and compare first image framing plus variant/gallery images.

Check in SAISON

Set product card image ratio, hover gallery, gallery image count, and swatch media behavior consistently.

When to contact support

Send the collection URL and three product handles showing the uneven cards.

What you see

Video feels slow, jumpy, or too heavy

Likely cause

Video file size, autoplay behavior, or too many motion-heavy sections are affecting perceived performance.

Check in Shopify

Use an optimized video file and set a poster image where available.

Check in SAISON

Avoid stacking video, scroll effects, and reveal effects back to back. Use simpler mobile fallback media when needed.

When to contact support

Send the video file size, affected section, and mobile/desktop behavior.

What you see

Text over media is hard to read

Likely cause

The image, overlay, text color, or content position does not provide enough contrast.

Check in Shopify

Confirm the final image is being used, not a temporary demo image.

Check in SAISON

Adjust overlay opacity, color scheme, text position, or use a section with a clearer text panel.

When to contact support

Send a screenshot of the first viewport and the section settings.

Common mistakes

  • Trying to solve a bad mobile crop with desktop-only settings.
  • Using low-resolution demo or social images in full-width hero sections.
  • Enabling product card gallery before confirming additional product images are consistently framed.
  • Placing critical text over busy media without an overlay or text panel.
  • Stacking several video or advanced motion sections near the top of the page.