Data quality & provenance

Know what’s documented.
See what’s still unknown.

A useful catalog makes its evidence visible. Here’s how to read the sources, identity, rights, and commercial data behind Shelfhelp.ai.

The same standard.
Different levels of evidence.

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.

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.

Existing products

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.

Evidence updates

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.

The audit baseline.

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.

4,279records audited
with unique asset IDs
800records missing
an official URL
16records missing
a brand name
359raw category labels
with mixed granularity

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 areaBaseline observationHow to interpret it
Official destinations3,479 populated URLs · 81.30%Some destinations identify a family, collection, or brand rather than an exact variant.
Variant labels671 populated · 15.68%An empty field does not establish that a product has no variants.
Asset identity4,279 unique asset IDsDistinct image records can represent the same real-world product. Uniqueness does not prove global product identity.
Category consistencyThree case-only category splitsOriginal labels mix departments and product types. Normalized taxonomy remains an editorial interpretation.
Approval disclosureAll audited records labeled portfolio_studyThis 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.

Four different questions.
Four different answers.

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.

01 / SOURCE

Where did the information come from?

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.

02 / IDENTITY

Which product does this record represent?

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.

03 / APPROVAL

Has a merchant approved the study?

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.

04 / RIGHTS

What use is actually permitted?

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.

Three pilots, with inspectable evidence.

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.

Graza Drizzle

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.

Spindrift Grapefruit

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.

Monos Carry-On

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.

What remains limited.

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.

Taxonomy & extracted attributes

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.

Price, stock & seller coverage

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.

Global product identity

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 & service benchmarks

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.

Programs are discoverable.
Enrollment is separate.

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.

Take the evidence into your build.

Search the catalog, inspect the record, and preserve the unknowns.

Developer documentation