Listing Health
Access from: Processes → Workflows
Audits the technical health of every active product listing (seller and vendor) on the configured connection and marketplace. Unlike the SEO content templates, this template detects structural issues: discrepancies between what you configure and what Amazon publishes, errors reported by Amazon, regulatory compliance problems and missing critical identifiers.
When it runs
- Default frequency: every Monday at 5:00 (workflow timezone).
- Editable from the workflow editor once cloned.
Higher frequency than SEO Content
This template runs weekly because its issues tend to appear reactively (Amazon changes, new regulations, sync errors) and require fast detection. The SEO Content templates run monthly because content changes more slowly.
How it works
Auto-fix vs manual review
| Type | Checks |
|---|---|
| Auto-fix available | — |
| Manual review | X01, X02, X03, C01, C02, C03, C04, C05, K01, K02, K03, K04 |
This template detects issues that only the user can resolve: uploading certifications, fixing categorization, regenerating identifiers, addressing Amazon notices. There are no possible automatic fixes.
Checks
Title not indexed correctly (X01)
- Severity: warning
- What it checks: That the title configured in the backend matches the title Amazon displays on the product frontend.
- Why it matters: When Amazon overrides your title because of invalid content (style guide violation, promotional language, length), the frontend shows a version different from the one you store. It is a sign that some SEO content check is failing and Amazon has stepped in.
- Amazon reference: Amazon search glossary.
- Auto-fix: no — investigate which rules the title violates and fix them (the SEO Content: Title template audits the most common ones).
- Task message: "Title shown to shoppers differs from what you submitted. This may indicate indexing issues or Amazon edits."
Bullets not indexed correctly (X02)
- Severity: warning
- What it checks: That the bullets configured in the backend match those on the frontend.
- Why it matters: Same as X01 but for bullets: if Amazon overrides them it signals non-compliance with bullet point rules. The SEO Content: Bullets template audits the common causes.
- Amazon reference: Product bullet point requirements.
- Auto-fix: no — fix the issues detected by the SEO Content: Bullets template.
- Task message: "Bullets shown to shoppers differ from backend. Content may not be indexing correctly."
Wrong browse node (X03)
- Severity: warning
- What it checks: That the category (
recommended_browse_nodes) configured matches the product's category on the frontend. - Why it matters: A wrong category prevents the product from showing in category-filtered searches and distorts BSR (Best Seller Rank): it may appear "Best Seller" in an irrelevant category while going unnoticed in the right one.
- Amazon reference: Browse Tree Guide.
- Auto-fix: no — requires updating the category from Seller/Vendor Central.
- Task message: "Browse node in search differs from submitted. This affects category placement and search relevance."
Amazon errors (C01)
- Severity: error
- What it checks: That the product has no
ERROR-type issues reported by Amazon. - Why it matters: Errors that Amazon reports on a listing block functionality (publication, search, BuyBox, etc.) and must be resolved as a priority. They appear in Manage Inventory → Errors in Seller Central.
- Amazon reference: Product detail page rules.
- Auto-fix: no — review and resolve the errors reported by Amazon in Seller/Vendor Central.
- Task message: "Amazon reports {errorCount} ERROR-level issues. These may cause listing suppression or restricted functionality."
Amazon warnings (C02)
- Severity: warning
- What it checks: That the product has no
WARNING-type issues reported by Amazon. - Why it matters: Warnings indicate issues that may escalate to errors or hurt the listing's visibility if ignored. They are early signals Amazon exposes so they can be solved before becoming blockers.
- Amazon reference: Product detail page rules.
- Auto-fix: no — review the warnings from Seller/Vendor Central.
- Task message: "Amazon reports {warningCount} WARNING-level issues. These should be addressed to prevent future suppression."
Listing not buyable / not discoverable (C03)
- Severity: error
- What it checks: That the listing has the
BUYABLEandDISCOVERABLEstatuses in its Amazon summary. - Why it matters:
BUYABLEmeans it can be purchased;DISCOVERABLEmeans it appears in search. Without one or both, the listing is broken: it either does not generate sales or does not receive traffic. It is one of the most critical catalog issues. - Amazon reference: Understanding Amazon listing status.
- Auto-fix: no — investigate the missing attributes that prevent the listing from being buyable/discoverable.
- Task message: "Listing is missing: {missing}. Products must be BUYABLE and DISCOVERABLE to generate sales."
Inactive product (C04)
- Severity: error
- What it checks: That the product's
amazonStatusisActive. - Why it matters: An inactive listing (Inactive, Incomplete, Discontinued, etc.) does not appear in search and does not generate sales. It is the first state to check: no SEO or advertising optimization has any effect on an inactive product.
- Amazon reference: Understanding Amazon listing status.
- Auto-fix: no — investigate the reason for the inactive status (suspended, no price, no stock, missing attributes…).
- Task message: "Product status is "{amazonStatus}" (not Active). Inactive products cannot be purchased by shoppers."
GPSR not attested (C05)
- Severity: warning
- What it checks: That products in EU marketplaces (ES, DE, FR, IT) have the
gpsr_safety_attestationattribute set totrue. - Why it matters: The General Product Safety Regulation came into force in the EU on 13 December 2024 and applies to all non-food products. Without the safety attestation or responsible person information, Amazon may remove the listing and make it ineligible for flash sales or promotions.
- Amazon reference: General Product Safety Regulation (GPSR).
- Auto-fix: no — complete the GPSR data in the Seller/Vendor Central compliance dashboard.
- Task message: "GPSR safety attestation is missing for EU marketplace {countryCode}. Required by EU regulation since 2024."
No EAN / UPC / GTIN (K01)
- Severity: warning
- What it checks: That the product has at least one valid EAN, UPC or GTIN identifier.
- Why it matters: Without a unique identifier, Amazon may limit the listing's visibility or prevent its publication. Most categories require a GTIN based on GS1 standards — only products eligible for a GTIN Exemption can be listed without one.
- Amazon reference: Product ID (GTIN) requirements by category.
- Auto-fix: no — register the product's GTIN or request an exemption if it applies.
- Task message: "No EAN, UPC, or GTIN identifier found. Missing identifiers may limit distribution and search placement."
No category assigned (K02)
- Severity: error
- What it checks: That the product has at least one category assigned (
classifications). - Why it matters: Without a category Amazon cannot classify the product: it does not appear in department navigation, its category-specific validation rules are not applied and it usually has additional indexation and BSR problems.
- Amazon reference: Browse Tree Guide.
- Auto-fix: no — assign the correct category from Seller/Vendor Central.
- Task message: "No category assigned. Products without a category have poor search visibility and may miss targeted promotions."
Shallow category (K03)
- Severity: warning
- What it checks: That the assigned category is at least 3 levels deep in the browse tree.
- Why it matters: A very generic category (e.g. only "Electronics" instead of "Electronics > Cameras > Surveillance Cameras > WiFi") reduces relevance in filtered searches and hurts BSR. More specific categories let the product compete in its real niche.
- Amazon reference: Browse Tree Guide.
- Auto-fix: no — reassign to a more specific sub-category.
- Task message: "Category has only {depth} levels. Deeper categorization improves search relevance and filter visibility."
No productType (K04)
- Severity: warning
- What it checks: That the product has the
productTypefield defined. - Why it matters: The productType is the field Amazon uses to apply the right validation rules and attributes to the listing. Without it, Amazon cannot know which rules to evaluate and the product stays in an ambiguous state that triggers cascading errors.
- Amazon reference: Product detail page rules.
- Auto-fix: no — set the productType from Seller/Vendor Central.
- Task message: "No Amazon productType assigned. This may affect search filters and category-specific features."
Next steps
- Templates catalog — back to the index
- Tasks — how to review and approve generated items
- Workflows — understand the engine underneath
- SEO Content: Title — related to X01
- SEO Content: Bullets — related to X02