Rule reference · Google Merchant Center
Google Merchant Center product data rules
Every Google Merchant Center rule this checker implements, with its requirement type, field, expected result, official source and last-verified date — and an explicit list of what it cannot evaluate.
64 versioned rules across 3 rulesets · ruleset 1.0.0 · rule data verified 11 November 2026 · no account needed for a local run
Rules
35 Google Merchant Center rules
Source type
Official Google documentation, per rule
Last verified
11 November 2026
Ruleset version
1.0.0
How to read this reference
- Required — the field is needed for the item to be submitted at all.
- Conditional — required only when the stated product context applies. The checker evaluates the condition and reports Not applicable when it does not apply.
- Recommended — guidance, not a blocking requirement; failures report as a warning.
- Optional — never a blocker.
- Informational — the checker records the guidance; it does not score it.
Each row states what the checker reports when the rule fails, from the same six-state model the results page uses. Nothing is aggregated: a rule that fails on one row fails on that row, and passing rows do not offset it.
Identifiers (6)
Item ID, GTIN, MPN and identifier_exists. A missing GTIN is not, by itself, an error.
Rule | Requirement | Field | Reported when it fails | Source |
|---|---|---|---|---|
Google item ID is missing GMC-ID-001 · v1.0.0 | required | id | Error Every item submitted in the Google product data profile must have an ID. Fix: Provide a stable non-empty ID and preserve it across updates. | Official source 11 November 2026 |
Google item ID is duplicated GMC-ID-002 · v1.0.0 | required | id | Error Google item IDs must uniquely identify feed items. Fix: Assign a stable unique ID to each item/variant. | Official source 11 November 2026 |
Google GTIN is malformed GMC-GTIN-001 · v1.0.0 | conditional | gtin | Error When supplied, GTIN must have a supported length and valid check digit. Missing GTIN alone is not a universal error. Fix: Correct the manufacturer-assigned GTIN. Never generate or guess one. | Official source 11 November 2026 |
Google MPN is required in this product context GMC-MPN-001 · v1.0.0 | conditional | mpn | Error MPN is required when no manufacturer-assigned GTIN exists and product context establishes an applicable/available MPN. Google allows omission when no clearly associated MPN exists or the product is a qualifying custom-made item. Missing GTIN alone is insufficient to assert a missing-MPN error. Fix: Supply the actual applicable manufacturer MPN only when one exists or is assigned under the relevant store-brand guidance. Never fabricate a manufacturer identifier. | Official source 11 November 2026 |
Google identifier_exists may conflict with identifiers GMC-IDENT-001 · v1.0.0 | optional | identifier_exists | Needs review A submitted identifier_exists value should be consistent with known product identifiers. Fix: Review the true identifier situation. Do not set false merely to bypass missing identifiers. | Official source 11 November 2026 |
GTIN must not be fabricated GMC-GTIN-002 · v1.0.0 | recommended | gtin | Needs review The checker never generates a GTIN. A missing or doubtful GTIN produces guidance only. Fix: Obtain the real GTIN from the manufacturer or supplier; never guess one. | Official source 11 November 2026 |
Title and description (4)
Presence and the published length maximums.
Rule | Requirement | Field | Reported when it fails | Source |
|---|---|---|---|---|
Google description is missing GMC-DESC-001 · v1.0.0 | required | description | Error The product description is required. Fix: Add a factual product description. | Official source 11 November 2026 |
Google description exceeds 5,000 characters GMC-DESC-002 · v1.0.0 | required | description | Error The plain description attribute has a 5,000-character maximum. Fix: Shorten the description without losing material product information. | Official source 11 November 2026 |
Google title is missing GMC-TITLE-001 · v1.0.0 | required | title | Error The product title is required. Fix: Add a clear product title. | Official source 11 November 2026 |
Google title exceeds 150 characters GMC-TITLE-002 · v1.0.0 | required | title | Error The plain title attribute has a 150-character maximum. Fix: Shorten the title while keeping the key product identity and variant details. | Official source 11 November 2026 |
Product link (1)
The landing-page URL must be an absolute public HTTP(S) URL.
Rule | Requirement | Field | Reported when it fails | Source |
|---|---|---|---|---|
Google product link is invalid GMC-LINK-001 · v1.0.0 | required | link | Error The product link must be an absolute HTTP(S) URL. Fix: Provide an absolute product landing-page URL. | Official source 11 November 2026 |
Images (15)
Dimensions over time, real file format, pixel count, file size, animation, decode, and the human-review items.
Rule | Requirement | Field | Reported when it fails | Source |
|---|---|---|---|---|
Google main image link is invalid GMC-IMG-001 · v1.0.0 | required | image_link | Error The main image link must be an absolute HTTP(S) URL. Fix: Provide an absolute direct image URL. | Official source 11 November 2026 |
Google image cannot be decoded GMC-IMG-DECODE-001 · v1.0.0 | required | image_link | Error The downloaded image bytes cannot be decoded as a supported image. Fix: Replace the file with a valid supported image. | Official source 11 November 2026 |
Google image format is unsupported GMC-IMG-FORMAT-001 · v1.0.0 | required | image_link | Error Supported formats are JPEG, WebP, PNG, non-animated GIF, BMP, and TIFF. Fix: Convert to a supported image format. | Official source 11 November 2026 |
Google image is an animated GIF GMC-IMG-GIF-001 · v1.0.0 | required | image_link | Error Animated GIF is not accepted for this product image usage. Fix: Provide a static image. | Official source 11 November 2026 |
Google image exceeds 64 megapixels GMC-IMG-MP-001 · v1.0.0 | required | image_link | Error The published image specification limits images to 64 megapixels. Fix: Resize from an original high-quality source while preserving image content. | Official source 11 November 2026 |
Google image exceeds file-size limit GMC-IMG-SIZE-001 · v1.0.0 | required | image_link | Error The published maximum image file size is 16 MB; exact decimal/binary boundary is not specified in the cited requirement. Fix: Reduce file size without degrading the product image unacceptably. | Official source 11 November 2026 |
Google image URL could not be verified GMC-IMG-URL-001 · v1.0.0 | required | image_link | Needs review Remote image access can be blocked by anti-hotlink rules, timeouts, or temporary failures. Fix: Check the image URL and hosting permissions; do not bypass access controls. | Official source 11 November 2026 |
Google image is below the 500×500 requirement GMC-IMG-FUTURE-001 · v1.0.0 | conditional | image_link | Error Google's official 2026 annual update says warnings begin 2026-04-14, while the dedicated image troubleshooting article says July 2026. The checker conservatively emits its own proactive warning from 2026-04-14; this does not assert that Merchant Center exposed warnings to every merchant on that date. At least 500x500 is enforced by Google from 2027-01-31. Fix: Use an original image with both dimensions at least 500 pixels. | Official source 11 November 2026 |
Google non-apparel image is below the legacy minimum GMC-IMG-LEGACY-001 · v1.0.0 | conditional | image_link | Error Before 2027-01-31, non-clothing products require at least 100×100 pixels; do not treat uncertain category classification as non-clothing. Fix: Use a source image meeting the applicable minimum dimensions; do not upscale a small image. | Official source 11 November 2026 |
Clothing image is smaller than the legacy minimum GMC-IMG-LEGACY-002 · v1.0.0 | conditional | image_link | Error Before 2027-01-31, clothing images require at least 250 x 250 pixels. Both width and height must meet the threshold. Fix: Replace the image with one at least 250 x 250 pixels; do not upscale. | Official source 11 November 2026 |
YouTube Shopping Ads image is smaller than 500 x 500 GMC-IMG-YT-001 · v1.0.0 | conditional | image_link | Error When the user explicitly selects the YouTube Shopping Ads target, both dimensions must be at least 500 pixels. Fix: Provide an image of at least 500 x 500 pixels for this destination. | Official source 11 November 2026 |
Google additional image URL is invalid GMC-ADDITIONAL-IMG-001 · v1.0.0 | optional | additional_image_link | Error Every supplied additional image URL must be a valid absolute HTTP(S) URL. Fix: Remove malformed entries or replace them with valid direct image URLs. | Official source 11 November 2026 |
Generative-AI image is missing expected provenance metadata GMC-IMG-AI-META-001 · v1.0.0 | recommended | image_link | Needs review Requires trustworthy metadata evidence and image provenance. Creation method must never be inferred from appearance. Fix: Preserve the IPTC metadata that records generative-AI creation. | Official source 11 November 2026 |
Google image is below recommended resolution GMC-IMG-RECOMMEND-001 · v1.0.0 | recommended | image_link | Warning Google recommends around 1500×1500 or higher; this is not a hard minimum. Fix: Consider a higher-resolution source image where available. | Official source 11 November 2026 |
Google image visual policy needs human review GMC-IMG-VISUAL-001 · v1.0.0 | informational | image_link | Not checked Metadata checks cannot determine reliably whether an image contains prohibited overlays, watermarks, placeholders, or the wrong product. Fix: Review the actual image against the official image policy. | Official source 11 November 2026 |
Availability (2)
The supported enum, plus availability_date for preorder and backorder.
Rule | Requirement | Field | Reported when it fails | Source |
|---|---|---|---|---|
Google availability value is invalid GMC-AVAIL-001 · v1.0.0 | required | availability | Error Google availability accepts in_stock, out_of_stock, preorder, or backorder. Fix: Use one of the supported enum values exactly. | Official source 11 November 2026 |
Google availability date is missing GMC-AVAIL-002 · v1.0.0 | conditional | availability_date | Error availability_date is required when availability is preorder or backorder. Fix: Provide the applicable ISO 8601 availability date/time. | Official source 11 November 2026 |
Price (2)
Presence and syntax, plus the opt-in comparison against the landing page.
Rule | Requirement | Field | Reported when it fails | Source |
|---|---|---|---|---|
Google price is missing or malformed GMC-PRICE-001 · v1.0.0 | required | price | Error The product price must contain a positive amount and ISO currency. Fix: Provide a valid price and explicit currency. | Official source 11 November 2026 |
Price or currency conflicts with the landing page GMC-PRICE-002 · v1.0.0 | conditional | price | Needs review Only compared when reliable landing-page evidence and a known target market exist. Definite conflict is an error; ambiguous multi-currency, member, coupon or variant pricing is a review item. Fix: Check that the feed price and currency match the active payable price on the landing page. | Official source 11 November 2026 |
Brand (2)
Conditional presence and placeholder detection.
Rule | Requirement | Field | Reported when it fails | Source |
|---|---|---|---|---|
Google brand is missing GMC-BRAND-001 · v1.0.0 | conditional | brand | Error Brand applicability depends on whether a clearly associated brand/manufacturer exists and the product context. Fix: Provide the true brand when applicable. If applicability cannot be established, supply context or review manually. | Official source 11 November 2026 |
Google brand looks like a placeholder GMC-BRAND-002 · v1.0.0 | recommended | brand | Warning Values such as N/A, Generic, or No brand can be misleading and must not be used as substitutes for a real brand. Fix: Use the real brand when one exists; otherwise follow Google’s no-brand guidance for the product. | Official source 11 November 2026 |
Condition (1)
Optional for new items, required for used and refurbished.
Rule | Requirement | Field | Reported when it fails | Source |
|---|---|---|---|---|
Google condition is missing or invalid GMC-COND-001 · v1.0.0 | conditional | condition | Error Condition is optional for new items and required for used or refurbished items. Fix: Use new, used, or refurbished as applicable; do not invent condition. | Official source 11 November 2026 |
Variants (2)
Grouping and per-variant option consistency.
Rule | Requirement | Field | Reported when it fails | Source |
|---|---|---|---|---|
Google variant grouping may be incomplete GMC-VARIANT-001 · v1.0.0 | conditional | item_group_id | Needs review Items that are variants of the same product may need a shared item_group_id and appropriate variant attributes. Fix: Group true variants consistently; applicability can vary by product type and target destination. | Official source 11 November 2026 |
Variant option values are inconsistent within a group GMC-VARIANT-002 · v1.0.0 | conditional | — | Needs review When color, size or material define variant selection, identical or mismatched option values inside one item group need review unless the contradiction is deterministic. Fix: Make each variant's distinguishing option values unique within its item group. | Official source 11 November 2026 |
The image date change, stated once
Before 2027-01-31
Legacy minimums still distinguish clothing (250×250) from most other products (100×100). An image above the legacy minimum but below 500×500 is reported as a warning during the proactive-warning phase; the official sources disagree on whether that phase began on 2026-04-14 or in July 2026, and the rule row says so.
From 2027-01-31
500×500 applies to every product image regardless of category, and the legacy rules stop applying. A run with an as-of date on or after that day reports a failure for every smaller image.
When the product category cannot be established from the file, the checker reports Needs review instead of guessing whether the clothing or non-clothing threshold applies — a guessed threshold would produce confident wrong answers.
What this ruleset cannot evaluate
- Account-level configuration: target countries, shipping setup, merchant account status, marketplace approvals. None of it is in the file, so a rule that depends on it never reports a hard failure because the context is missing.
- Category-specific requirements beyond the ones the registry models. The MVP does not ingest Google’s product taxonomy.
- Whether an image violates content policy — overlays, watermarks, promotional text, placeholders, wrong product. That is a human judgement.
- Whether a page renders correctly for users: only static HTML evidence is used, never a browser render.
- Whether Google will approve, reject or show the item. There is no approval signal in this output.
Sources used by this ruleset
- https://support.google.com/merchants/answer/7052112
- https://support.google.com/merchants/answer/6324448
- https://support.google.com/merchants/answer/6324470
- https://support.google.com/merchants/answer/6324351
- https://support.google.com/merchants/answer/6324469
- https://support.google.com/merchants/answer/6324461
- https://support.google.com/merchants/answer/6324482
- https://support.google.com/merchants/answer/6324350
- https://support.google.com/merchants/answer/12159030
- https://support.google.com/merchants/answer/16989427
Every rule above carries its own source URL and last-verified date. Sources are re-checked before release and at least monthly, because platform requirements change. Where two official pages disagree, the registry records both and the rule states which one the checker follows and why.