← back to Consulting Designerwallcoverings Com

TK-20: AEO JSON-LD injector draft + read-only render-verify

d9016b7e484a2ae51c1554cdf66f052e2b206313 · 2026-07-26 21:09:17 -0700 · Steve Abrams

- docs/aeo-drafts/dw-aeo-jsonld.liquid: handle-keyed FAQPage/CollectionPage/WebPage
  JSON-LD snippet (versace-wallpaper + osborne-little collections, wall-coverings page),
  generated from the committed .jsonld graphs, mirrors visible body_html FAQ verbatim.
  DTD verdict A (unanimous 5/5) — single snippet rendered from theme.liquid head.
- scripts/aeo-render-verify.mjs: read-only Playwright render check (all 3 render body_html;
  hasJsonLdFaq=false confirms the gap this snippet fills).
- render-proof/: saved render-verify JSON.
Gated theme-write memo -> pending-approval/tk20-aeo-jsonld-snippet-and-nav.md. No theme write.

Files touched

• A docs/aeo-drafts/dw-aeo-jsonld.liquid

Diff

commit d9016b7e484a2ae51c1554cdf66f052e2b206313
Author: Steve Abrams <steve@designerwallcoverings.com>
Date:   Sun Jul 26 21:09:17 2026 -0700

    TK-20: AEO JSON-LD injector draft + read-only render-verify
    
    - docs/aeo-drafts/dw-aeo-jsonld.liquid: handle-keyed FAQPage/CollectionPage/WebPage
      JSON-LD snippet (versace-wallpaper + osborne-little collections, wall-coverings page),
      generated from the committed .jsonld graphs, mirrors visible body_html FAQ verbatim.
      DTD verdict A (unanimous 5/5) — single snippet rendered from theme.liquid head.
    - scripts/aeo-render-verify.mjs: read-only Playwright render check (all 3 render body_html;
      hasJsonLdFaq=false confirms the gap this snippet fills).
    - render-proof/: saved render-verify JSON.
    Gated theme-write memo -> pending-approval/tk20-aeo-jsonld-snippet-and-nav.md. No theme write.
---
 docs/aeo-drafts/dw-aeo-jsonld.liquid | 47 ++++++++++++++++++++++++++++++++++++
 1 file changed, 47 insertions(+)

diff --git a/docs/aeo-drafts/dw-aeo-jsonld.liquid b/docs/aeo-drafts/dw-aeo-jsonld.liquid
new file mode 100644
index 0000000..3849417
--- /dev/null
+++ b/docs/aeo-drafts/dw-aeo-jsonld.liquid
@@ -0,0 +1,47 @@
+{%- comment -%}
+  dw-aeo-jsonld.liquid — TK-20 AEO structured-data injector (DRAFT for Steve's session)
+  --------------------------------------------------------------------------------------
+  Emits the committed per-handle FAQPage + CollectionPage/WebPage JSON-LD graphs for the
+  striking-distance AEO targets. Shopify strips <script> from collection body_html, so the
+  schema for these pages CANNOT ride in the description — it rides here instead.
+
+  DTD verdict 2026-07-26 (UNANIMOUS 5/5 Claude+Codex+Qwen+Grok+Kimi, Option A): a single
+  handle-keyed snippet rendered ONCE from layout/theme.liquid (right after
+  {{ content_for_header }}) is the uniform, self-contained path across the 2 collections
+  AND the /pages/wall-coverings PAGE, with zero metafield writes.
+
+  SOURCE OF TRUTH: docs/aeo-drafts/{versace-wallpaper,osborne-and-little,wall-coverings}.jsonld
+  (this file is generated from them). The graph text below MIRRORS the visible AEO answer +
+  6-FAQ accordion already published in each target's body_html (Google content-match rule).
+
+  COVERAGE = the 3 LIVE handles only. zuber-wallcoverings + a future designer-wallpaper page
+  are intentionally NOT emitted yet — their visible FAQ bodies are not published, and a
+  FAQPage without matching visible FAQ text is schema spam. Add a {% when %} branch for each
+  ONLY after its body_html AEO block is live.
+
+  GUARD: do NOT also populate collection.metafields.custom.faq for these handles — that would
+  make sections/dw-collection-hero.liquid emit a SECOND (duplicate) FAQPage + visible accordion.
+  This snippet is the single FAQPage source for these 3 handles.
+
+  Render hook (layout/theme.liquid, immediately after {{ content_for_header }}):
+      {% render 'dw-aeo-jsonld' %}
+{%- endcomment -%}
+{%- if template.name == 'collection' -%}
+  {%- case collection.handle -%}
+    {%- when 'versace-wallpaper' -%}
+<script type="application/ld+json">
+{"@context":"https://schema.org","@graph":[{"@type":"CollectionPage","@id":"https://www.designerwallcoverings.com/collections/versace-wallpaper#collectionpage","url":"https://www.designerwallcoverings.com/collections/versace-wallpaper","name":"Versace Wallpaper — Versace Home Collection","description":"Versace Home wallcovering: Medusa, Greca (Greek key), and Barocco baroque damask designs in premium non-woven panels. Carried by Designer Wallcoverings with $4.25 memo samples.","about":[{"@type":"Brand","name":"Versace"},{"@type":"Organization","name":"Gianni Versace S.r.l."}],"isPartOf":{"@type":"WebSite","name":"Designer Wallcoverings","url":"https://www.designerwallcoverings.com"},"keywords":"versace wallpaper, versace home, medusa wallpaper, greek key wallpaper, barocco, baroque damask, luxury designer wallpaper"},{"@type":"FAQPage","@id":"https://www.designerwallcoverings.com/collections/versace-wallpaper#faq","mainEntity":[{"@type":"Question","name":"What is Versace wallpaper?","acceptedAnswer":{"@type":"Answer","text":"Versace wallpaper is the official wallcovering range of the Italian fashion house Versace, produced under license and sold through specialty design retailers including Designer Wallcoverings. It renders Versace's Baroque design language — the Medusa emblem, the Greek-key Greca border, and Barocco damask — as premium non-woven wall panels."}},{"@type":"Question","name":"How much does Versace wallpaper cost?","acceptedAnswer":{"@type":"Answer","text":"Versace Home wallpaper is a luxury line; pricing is per roll and varies by pattern and colorway. Designer Wallcoverings lists current per-roll pricing on each product page and offers a $4.25 memo sample so you can confirm color and scale before ordering full rolls."}},{"@type":"Question","name":"Is Versace wallpaper authentic?","acceptedAnswer":{"@type":"Answer","text":"Versace Home wallcovering is produced under official license (manufactured by A.S. Creation) and carries Versace branding. Designer Wallcoverings carries the Versace Home line as a genuine, licensed product."}},{"@type":"Question","name":"What patterns does Versace wallpaper come in?","acceptedAnswer":{"@type":"Answer","text":"The most requested designs are the Medusa medallion, the Greca Greek-key border, Barocco baroque damask, the La Coupe des Dieux mythological scenic, and animalier (leopard) prints, in colorways from black-and-gold to ivory and jewel tones."}},{"@type":"Question","name":"How do I hang Versace wallpaper?","acceptedAnswer":{"@type":"Answer","text":"Most Versace Home rolls are non-woven and paste-the-wall — you apply adhesive to the wall and hang the dry panel, which makes installation cleaner and future removal easier than traditional paste-the-paper hangings. Order one extra roll for pattern-match waste."}},{"@type":"Question","name":"Can I get a sample of Versace wallpaper before I buy?","acceptedAnswer":{"@type":"Answer","text":"Yes — Designer Wallcoverings offers a $4.25 memo sample on Versace Home patterns so you can check the true color, sheen, and gilding in your own light before committing to full rolls."}}]}]}
+</script>
+    {%- when 'osborne-little' -%}
+<script type="application/ld+json">
+{"@context":"https://schema.org","@graph":[{"@type":"CollectionPage","@id":"https://www.designerwallcoverings.com/collections/osborne-little#collectionpage","url":"https://www.designerwallcoverings.com/collections/osborne-little","name":"Osborne & Little Wallpaper & Fabric","description":"Osborne & Little — the British luxury wallpaper and fabric house founded in London in 1968. Pattern-led designs, sold by the roll and the yard, with $4.25 memo samples.","about":[{"@type":"Brand","name":"Osborne & Little"},{"@type":"Organization","name":"Osborne & Little","foundingDate":"1968","foundingLocation":"London, England"}],"isPartOf":{"@type":"WebSite","name":"Designer Wallcoverings","url":"https://www.designerwallcoverings.com"},"keywords":"osborne and little, osborne & little wallpaper, osborne little fabric, british designer wallpaper, nina campbell, matthew williamson"},{"@type":"FAQPage","@id":"https://www.designerwallcoverings.com/collections/osborne-little#faq","mainEntity":[{"@type":"Question","name":"Who are Osborne & Little?","acceptedAnswer":{"@type":"Answer","text":"Osborne & Little is a British design house founded in London in 1968 by Peter Osborne and Antony Little. It designs and manufactures luxury wallpapers and fabrics and is regarded as one of England's leading interior-design brands."}},{"@type":"Question","name":"Where can I buy Osborne & Little wallpaper?","acceptedAnswer":{"@type":"Answer","text":"Osborne & Little is sold through specialty interior retailers, including Designer Wallcoverings, which carries the Osborne & Little wallpaper and fabric range with full-roll ordering, current pricing on each product page, and $4.25 memo samples."}},{"@type":"Question","name":"Is Osborne & Little wallpaper expensive?","acceptedAnswer":{"@type":"Answer","text":"Osborne & Little is a premium designer line, priced per roll above mass-market wallpaper. Exact pricing depends on the collection and colorway and is shown on each Designer Wallcoverings product page; order a $4.25 memo sample first to confirm the match."}},{"@type":"Question","name":"Does Osborne & Little make fabric as well as wallpaper?","acceptedAnswer":{"@type":"Answer","text":"Yes. Osborne & Little produces both wallpapers (sold by the roll) and coordinating fabrics (sold by the yard). Designer Wallcoverings carries both, so you can pair a wallcovering with a matching or complementary drapery or upholstery fabric."}},{"@type":"Question","name":"What is Osborne & Little known for?","acceptedAnswer":{"@type":"Answer","text":"Pattern-led British design — botanical and floral trails, damasks, chinoiserie, and bold geometrics, often on metallic or richly colored grounds. The group also produces the Nina Campbell and Matthew Williamson lines."}},{"@type":"Question","name":"Can I order a sample of Osborne & Little wallpaper?","acceptedAnswer":{"@type":"Answer","text":"Yes — Designer Wallcoverings offers a $4.25 memo sample so you can see the true color, scale, and finish in your own room before buying full rolls."}}]}]}
+</script>
+  {%- endcase -%}
+{%- elsif template.name == 'page' -%}
+  {%- case page.handle -%}
+    {%- when 'wall-coverings' -%}
+<script type="application/ld+json">
+{"@context":"https://schema.org","@graph":[{"@type":"WebPage","@id":"https://www.designerwallcoverings.com/pages/wall-coverings#webpage","url":"https://www.designerwallcoverings.com/pages/wall-coverings","name":"Wall Coverings — Types, Materials & How to Choose","description":"A guide to wall coverings: wallpaper, grasscloth, vinyl, cork, silk, flocked, mural, and commercial Type II wallcoverings — and how to choose. Thousands of designs with $4.25 memo samples.","about":{"@type":"Thing","name":"Wall coverings"},"isPartOf":{"@type":"WebSite","name":"Designer Wallcoverings","url":"https://www.designerwallcoverings.com"},"keywords":"wall coverings, wallcoverings, types of wall coverings, grasscloth, vinyl wallcovering, cork, silk, flocked, commercial wallcovering, type ii"},{"@type":"FAQPage","@id":"https://www.designerwallcoverings.com/pages/wall-coverings#faq","mainEntity":[{"@type":"Question","name":"What are wall coverings?","acceptedAnswer":{"@type":"Answer","text":"Wall coverings are materials applied to interior walls for decoration or protection. They include wallpaper, grasscloth, vinyl, cork, silk, flocked, and mural wallcoverings, as well as durable commercial (Type II) contract wallcoverings. Designer Wallcoverings carries thousands across these categories."}},{"@type":"Question","name":"What is the difference between wallpaper and wall coverings?","acceptedAnswer":{"@type":"Answer","text":"'Wallpaper' usually refers to printed paper or non-woven wall material, while 'wall coverings' is the broader umbrella that also includes grasscloth, vinyl, cork, silk, textile, and commercial-grade materials. All wallpaper is a wall covering, but not all wall coverings are paper."}},{"@type":"Question","name":"What are the most durable wall coverings?","acceptedAnswer":{"@type":"Answer","text":"Type II commercial vinyl wallcoverings are the most durable and are rated for high-traffic and hospitality use; they resist scrubbing and abrasion. For residential durability, non-woven and washable vinyl papers hold up well in kitchens and baths."}},{"@type":"Question","name":"How much do wall coverings cost?","acceptedAnswer":{"@type":"Answer","text":"It depends on the material and design house — residential designer wallpaper is priced per roll, textiles and specialty materials per yard, and hand-crafted scenics are made to order. Designer Wallcoverings shows current pricing on every product page and offers a $4.25 memo sample."}},{"@type":"Question","name":"Can I get samples of wall coverings before buying?","acceptedAnswer":{"@type":"Answer","text":"Yes. Designer Wallcoverings offers a $4.25 memo sample on most patterns so you can confirm color, texture, and scale in your own light before ordering full rolls or yardage."}},{"@type":"Question","name":"What types of wall coverings does Designer Wallcoverings carry?","acceptedAnswer":{"@type":"Answer","text":"Residential and commercial: designer wallpaper, grasscloth, vinyl, cork, silk, flocked, metallic/mica, and murals/scenics — from houses including Cole & Son, Osborne & Little, Versace Home, Zuber, de Gournay, Schumacher, and Thibaut."}}]}]}
+</script>
+  {%- endcase -%}
+{%- endif -%}

← b5fc1de TK-20 verify: Playwright render-check (all 3 published, but  ·  back to Consulting Designerwallcoverings Com  ·  TK-20: harden APPLY-page-jsonld.sh step[2] — fetch-live + ab f2191dc →