TikTok ShopCriticalProduct rejected or rendered with hard cropping

How to Fix “Image aspect ratio not supported” in TikTok Catalog

TikTok catalog placements are built around square imagery. Portrait or landscape assets are either rejected or centre-cropped, which cuts the product out of the frame.

Free, no signup

Scan your feed for this error for free

Paste your product feed URL (XML, CSV or JSON). The audit checks Image aspect ratio not supported (must be 1:1) along with 25+ other pre-channel rules.

Why this happens

Technical root cause

Storefront photography is shot for product pages, commonly at 4:5 or 3:2. Feed exports pass the original aspect ratio through with no canvas normalization step.

TikTok Catalog reports it as Image aspect ratio not supported (must be 1:1) and applies: Product rejected or rendered with hard cropping.

Native CMS friction

  • Shopify

    Images keep whatever ratio was uploaded; theme cropping is CSS-only and never reaches the asset.

  • VTEX

    Size parameters in the image path can force dimensions, but defaults preserve the original ratio.

  • WooCommerce

    Hard-crop thumbnail sizes apply to theme sizes, not to the full-size URL published in feeds.

Fixing it manually

  1. 1

    Check the dimensions of the rejected images and identify the ratio.

  2. 2

    Re-render them onto a square canvas with a neutral background instead of cropping.

  3. 3

    Target at least 600x600 pixels; 1000x1000 is safer for TikTok Shop.

  4. 4

    Update image_link and revalidate the catalog upload.

The IRONFEED automated solution

One rule, applied to every product on every export. No spreadsheets, no re-uploads.

Rule syntax
IF aspect_ratio(image_link) != 1
  SET image_link = pad_square(image_link, background='#FFFFFF')
  ELSE SET image_link = force_https(image_link)

Run automatic linter checks before TikTok Catalog crawls your feed. IRONFEED validates every export against the channel spec, so this error is caught in Feed Review instead of in your channel dashboard.

Start free trial See how mapping rules work

Attribute requirements

TikTok Catalog attribute requirements for Image aspect ratio not supported (must be 1:1) and the matching IRONFEED transformation
AttributeTikTok Shop requirementAccepted formatIRONFEED transformation
image_linkRequired; 1:1 aspect ratioAbsolute HTTPS URL, JPEG or PNG, at least 600x600Square canvas padding via the image transformation pipeline
additional_image_linkOptionalComma-separated HTTPS URLs, same ratio rulesSame padding rule applied to every entry

Frequently asked questions

Yes for catalogs. Cropping removes product edges, while padding keeps the whole item visible inside the square frame.

Prefer a solid neutral background; transparency renders unpredictably across TikTok surfaces.

Related Feed Issues & Fixes

Other critical errors affecting catalog performance on Google, Meta, TikTok, and Mercado Libre.

Meta AdsCritical

Image resolution is too low (< 500x500)

Storefront platforms serve derivative image sizes through URL parameters or filename suffixes. Feed exports commonly reuse the listing thumbnail rather than requesting the original asset from the CDN.

View Fix & Rule
TikTok ShopCritical

Category ID missing or invalid for TikTok taxonomy

Most catalogs already carry a Google taxonomy value because Merchant Center requires it. TikTok expects a numeric TikTok category ID, so the value has to be cross-mapped rather than reused.

View Fix & Rule
TikTok ShopCritical

SKU ID cannot be empty

SKU is an optional merchandising field in most storefronts. Products created quickly, or imported in bulk, frequently have no SKU at all, and the export writes an empty cell rather than deriving an identifier.

View Fix & Rule

Looking for a different error?

Browse all TikTok Shop errors See every platform