Merchant Center Diagnostics: A Practical Review Guide
Merchant Center diagnostics are useful when they are treated as evidence about a product-data or account-state problem, not as a button that automatically explains the root cause. A good review identifies the affected account, product, market, destination, issue type, source data, landing page, and required owner. Google’s guidance for requesting issue reviews notes that product-level issues appear in the products area and that pricing and availability should match the landing pages before requesting a review.
This page is educational and does not promise approval, issue removal, traffic, or a particular Merchant Center interface. Use Merchant Center feed audit, product feed optimization, and Google Shopping feed optimization for related work. An alert such as out-of-stock product alerts can provide an earlier signal, but diagnostics still require product-specific evidence and an authorized correction.
Define the diagnostic question first
Start with the question the review must answer: Is one product disapproved? Is a category of items missing? Is an account-level warning blocking destinations? Are price or availability values stale? Is the submitted item inconsistent with its landing page? “Check diagnostics” is an activity; “prove whether the product row and page agree for market X” is a diagnostic contract.
Record the account, data source, product ID, item-group or variant key, market, language, destination, issue label, first observed time, latest observed time, source timestamps, landing-page URL, owner, severity, and permitted action. Preserve the issue wording and reference where possible, but do not treat the label as a complete root-cause analysis.
Separate product issues from account issues
A product-level issue can affect one offer or a defined group. An account-level issue can affect eligibility, policy standing, or many products. A feed processing warning can affect the source without proving that every product is wrong. Keep these scopes separate so an operator does not make a broad catalog change to solve a single-item problem or request a review before the account-level cause is fixed.
Classify the evidence and likely owner
Use the issue scope and the data path to identify who can actually correct it. A diagnostic record should distinguish the observed symptom from the proposed cause:
| Evidence or symptom | What it can establish | First owner to route |
|---|---|---|
| Feed row rejected or not processed | The submitted source did not produce the expected item | Feed or integration owner |
| Price mismatch | Submitted and customer-visible price differ at an observed time | Catalog, commerce, or pricing owner |
| Availability mismatch | Feed, page, structured data, or checkout states disagree | Inventory and commerce owners |
| Missing required attribute | The row lacks a value required for its population | Catalog or merchandising owner |
| Policy or account warning | A broader eligibility or policy concern is reported | Account or policy owner |
| Variant landing-page issue | The row and selected product configuration do not agree | Commerce platform owner |
| Stale data timestamp | Freshness cannot be established within the source contract | Integration owner |
The interface may provide a suggested action, but confirm that it addresses the observed evidence. A “fix” link can take an operator to a field editor while the real issue is a higher-precedence feed, a cache, a market restriction, or a landing-page renderer. Route the issue to the system that owns the fact, not only to the screen that displays the warning.
Track severity by consequence and scope
Severity should derive from the diagnostic contract. A single warning on an unaffected product may be low priority, while a false “in stock” state across a market can create both customer harm and disapprovals. Record affected count, destinations, markets, revenue or business priority only when the owner has defined those measures, and whether the issue blocks a required outcome.
Do not use a high count as proof of a shared cause. Thousands of rows can fail for one source outage, or they can contain several unrelated data problems. Group by issue code, source, field, market, product family, and observed time before choosing a broad correction.
Reconstruct the product-data path
Trace the item from source to customer. The path may include the commerce catalog, inventory or pricing service, primary data source, supplemental source, attribute rules, Merchant Center processing, product page, structured data, checkout, and destination configuration. Record each boundary and the timestamp at which it produced the value.
For the exact product, compare:
- Product ID, item-group ID, variant key, brand, product type, and category.
- Title, description, image, identifiers, size, color, material, and pack count.
- Price, currency, sale price, shipping, taxes where relevant, and availability.
- Product page URL, visible values, selected configuration, and purchase control.
- Feed source, transformation or rule, last submitted value, processing status, and diagnostics.
- Market, language, target destination, local inventory or regional availability.
Google’s availability documentation is a useful reference for the distinction between in-stock, out-of-stock, preorder, and backorder states. The key diagnostic question is not just which value is in the feed; it is whether the value accurately represents the offer a customer can buy in the target context.
Preserve timestamps and exact values
Capture source time, feed generation time, upload or retrieval time, processing time, page observation time, and checkout observation time when available. A mismatch that existed for five minutes during a catalog refresh is different from one that persists after several successful updates. Do not overwrite evidence with the latest value before recording the earlier state.
If the product page changes by location, device, login, or selected variant, record the observation context. A page that appears in stock to an operator in one country does not prove availability in every target market. Unknown context should be marked unknown, not treated as agreement.
Investigate common diagnostic categories
Price and availability mismatches
Compare the feed value with the product page, structured data, and checkout. Include currency, sale period, tax display, shipping, quantity, and regional rules. A feed update that succeeds can still be stale if the source generated an old value. Google’s product data specification describes the need for accurate price and availability data.
Correct the source that owns the fact. Do not make a feed rule force a value that contradicts the page, and do not change the page merely to satisfy a feed if the commerce system is correct. When the state is temporarily uncertain, follow the documented inventory fallback and expose the freshness problem.
Missing or invalid attributes
First confirm whether the attribute is required for the affected product, market, and destination. Check spelling, enumerated values, units, encoding, variant grain, and source precedence. A missing attribute may be a source omission, a failed join, an overly narrow condition, or a valid exception mislabeled as an error.
Use attribute rules only when the source and transformation are authorized. Do not fill a missing identifier, brand, material, or safety claim with a plausible default. A visible unresolved issue is safer than a false product fact.
Policy, landing-page, and account issues
Read the current policy or issue reference and compare it with the actual page and product data. Check whether the issue is at account, domain, product, destination, or market scope. Record evidence such as page content, business identity, checkout availability, shipping terms, and required documentation only when the responsible owner authorizes collection.
Do not request a review while the evidence still shows the issue is present. Google’s review guidance says to fix the issue and verify product data before requesting review where that option is available. A review request is a workflow step after correction, not a substitute for correction.
Create a fix plan that changes the smallest boundary
Choose the smallest authorized fix that can satisfy the diagnostic contract. Examples include correcting one catalog field, repairing a key join, updating an inventory source, adjusting an approved attribute rule, fixing variant URL selection, or changing a destination setting. Keep unrelated fields unchanged.
Write a before-and-after record with product population, source, transformation, owner, reviewer, effective time, expected diagnostic change, and rollback. If a bulk fix is proposed, define why the affected rows share the same cause and how exceptions will be protected. If they do not share a cause, split the work.
Handle temporary outages and stale inputs
When a source or page is unavailable, mark the diagnostic as degraded. Do not infer that an unavailable response means a product is out of stock, and do not infer that a successful fetch means the value is current. Use the source’s documented retry and fallback behavior, and escalate when that contract is missing.
If a data source was recently changed, compare the source version and rule version with the first observed issue. Preserve the old input and the new input. This makes it possible to roll back a defective transformation without discarding unrelated catalog improvements.
Verify the correction in stages
Verification should follow the same path as the failure:
- Confirm the authoritative source has the intended value.
- Confirm the generated row or supplemental update contains that value.
- Confirm Merchant Center processed the row for the intended market and destination.
- Recheck the exact product page, variant, price, availability, and structured data.
- Check the diagnostic status and any related products or account issues.
- Confirm the customer action, such as adding the item to cart, when that is in scope.
Classify the outcome as fixed, partially fixed, unresolved, superseded, or unable to verify. “Processed” means the platform accepted a source; it does not necessarily mean the customer-facing path is correct. “No issue visible” may mean the interface has not refreshed; preserve observation time and wait according to the authorized process rather than claiming resolution prematurely.
Request review only with an evidence packet
If a review is available and authorized, attach the issue reference, corrected source values, page evidence, affected scope, policy or specification check, and the owner’s statement that the contract is satisfied. Keep the review decision and any cooldown or follow-up state in the incident record. Do not submit repeated appeals without new evidence or an owner decision.
Monitor diagnostics for recurring causes
Trend issues by product family, source, attribute, market, language, destination, integration version, and time. Recurring price or availability problems often indicate freshness or ownership failures. Repeated missing attributes may indicate a key mismatch or product-family onboarding gap. A recurring policy issue may require a page or business-process change rather than another data transformation.
Use Google Shopping feed optimization for broader data-quality improvements and Merchant Center feed audit to maintain a repeatable evidence review. Keep diagnostic monitoring separate from campaign performance analysis. A product can be eligible yet commercially weak, or receive clicks while having a data-quality risk that has not surfaced yet.
Do not turn a diagnostic count into an unsupported performance target. Counts are evidence for prioritization when the owner defines the decision; they are not proof that every issue has the same importance or root cause.
Merchant Center diagnostics review checklist
Before closing a diagnostic, confirm:
- The issue scope, product or account, market, language, and destination are explicit.
- The original issue text, exact values, source versions, and timestamps are preserved.
- The product path from catalog to page and checkout has been traced.
- The likely owner and permitted fix are identified.
- Variant, regional, local-inventory, price, availability, and structured-data cases were considered where relevant.
- The smallest change was applied with a rollback record.
- Processing, diagnostics, page, and customer path were verified after the change.
- Any review request was made only after the evidence supported it.
- Recurring patterns were routed upstream instead of hidden with exceptions.
Merchant Center diagnostics work is complete when the reported issue is connected to evidence, the correction belongs to an authorized owner, and recovery is verified at the exact scope that failed. Treat diagnostics as a disciplined investigation: the interface is a valuable signal, but accurate product data, current pages, and clear ownership are what close the gap.