New products
The ingestion gate rejects a missing or invalid profile. Schema validation checks the record’s structure. It does not independently verify a submitted product claim, image review, or merchant relationship.
Data quality & provenance
A useful catalog makes its evidence visible. Here’s how to read the sources, identity, rights, and commercial data behind Shelfhelp.ai.
Every new product must supply a valid commerce profile. The profile keeps imagery, decision facts, source evidence, and purchasing status together. Read the product standard for the contract and its readiness rules.
The ingestion gate rejects a missing or invalid profile. Schema validation checks the record’s structure. It does not independently verify a submitted product claim, image review, or merchant relationship.
Legacy records are mapped into the same decision format while retaining their existing images and IDs. Missing evidence stays missing; migration does not grant merchant approval, a license, a current offer, or checkout access.
Validated profile revisions can add or correct facts without replacing an image. Each revision records a public reason and date. Inspect get_product_evidence_history for the recorded changes and source observation dates; a recent update date alone does not make a source current.
Readiness is earned by evidence. Image, decision, offer, and checkout readiness describe different requirements. A product can be visible in the library while its purchasing data is incomplete. Native checkout remains disabled until an authorized merchant integration is in place.
On 7 November 2026, the inventory audit retrieved every public record through 214 sequential pages. These are pre-upgrade observations, preserved as a dated baseline. Current totals can differ.
Audit baseline only. URL population is a completeness measure, not proof that every link is current or matches an exact SKU. Declared image dimensions were counted; this inventory pass did not validate every image file.
| Measured area | Baseline observation | How to interpret it |
|---|---|---|
| Official destinations | 3,479 populated URLs · 81.30% | Some destinations identify a family, collection, or brand rather than an exact variant. |
| Variant labels | 671 populated · 15.68% | An empty field does not establish that a product has no variants. |
| Asset identity | 4,279 unique asset IDs | Distinct image records can represent the same real-world product. Uniqueness does not prove global product identity. |
| Category consistency | Three case-only category splits | Original labels mix departments and product types. Normalized taxonomy remains an editorial interpretation. |
| Approval disclosure | All audited records labeled portfolio_study | This documents the catalog’s approval state at audit time. It does not establish a license or brand endorsement. |
For current coverage, use get_catalog_health. The MCP tool and public health endpoint report the catalog they observe when called. You can also inspect records through public discovery. A data-health report does not measure service uptime.
A source check, a product match, an approval, and a usage license each establish something different. Read them separately before making a recommendation or publishing an image.
Provenance can include a source URL, observation date, method, and verification scope. A legacy verified_source label alone is not complete evidence. Missing dates stay unknown, and an observed page is not a live stock check.
Asset, product, and variant IDs organize this catalog. They do not guarantee an externally resolved SKU or GTIN. A title-based match is an inference unless additional evidence verifies the depicted product and variant.
portfolio_study and merchant_approved describe approval status. Neither can be inferred from an official product link. Check the current record rather than assuming every catalog image shares the same status.
The imagery is AI-generated. A public download, verified source, or merchant approval does not by itself establish usage rights. Where a license is absent, reuse status remains not_established.
The 7 November 2026 review records eight facts and one dated merchant offer for each pilot. Image identity and geometry approval remain incomplete; no affiliate earnings or continuous inventory checks are claimed.
A 500 mL bottle and a one-bottle offer. The pictured label’s origin and olive variety are qualified by the current FAQ: batches can vary.
One can pictured, a 24-can case sold. Ingredients and nutrition are tied to the published 355 mL serving; the case SKU stays with the offer.
The merchant offer selects Desert Taupe. Its product page and FAQ disagree on weight, so weight remains unresolved. The render’s exact generation is not established.
Schema 4 adds structured context while retaining the existing image fields. More structure makes missing evidence easier to see; it does not turn missing facts into verified ones.
Category mappings are editorial inferences. Variant labels or quantities extracted from titles retain their extraction status. A number on a label is not automatically a verified capacity, dose, ingredient, or specification.
Profiles can be refreshed through authorized owner updates, but there is no automatic merchant feed polling or catalog-wide live price and stock feed. Any documented offer is limited to its source, seller, region, package, and observation time. Empty offer data means unknown, not unavailable or free.
GTIN, manufacturer part number, merchant SKU, product-family grouping, and cross-merchant matching are not guaranteed. Multiple asset records may intentionally show the same product.
Search uses lexical ranking with bounded typo and synonym handling. There are no semantic embeddings. A production load benchmark and an independently measured availability SLA have not been established.
Unknown is a useful answer. Preserve it in exports, comparisons, and agent responses. A missing specification should not become a guess, and an official product-family page should not be presented as proof of an exact variant.
Official public sources document programs for the brands below. These observations establish program information, not this catalog’s participation, commission terms, eligibility, or active tracking links.
On 7 November 2026, this pilot review added Graza and Monos program sources alongside the existing registry. NEMO, Ritual, Seed, Owala, and Monos offered applications. AG1 published affiliate terms; Graza provided an affiliate inquiry route. Program details may change. Use get_affiliate_programs to inspect sources and dates. No direct Spindrift program was verified.
Enrollment remains unknown. A program URL is an informational source, not an affiliate tracking link.
Search the catalog, inspect the record, and preserve the unknowns.