Shopify

Shopify Proxy-Free Setup: Add Legible Markdown to Your Storefront

Learn how to add Legible's discovery tags and hosted Markdown links to your Shopify storefront using Liquid templates. Our proxy-free guide ensures seamless integration for enhanced content discovery.

5 min readUpdated 2026-03-21Proxy-Free Guides
Why this matters

Shopify themes render Liquid server-side, which makes them a good fit for Legible's proxy-free discovery model.

Global Setup In `theme.liquid`

Add Legible's global tags inside the main `<head>` block so every page advertises the hosted AI endpoints.

Template-Specific Markdown Tags

{% if article %}
  <link rel="alternate" type="text/markdown" href="https://read.yourdomain.com/{{ article.handle }}.md" />
{% endif %}

{% if page %}
  <link rel="alternate" type="text/markdown" href="https://read.yourdomain.com/{{ page.handle }}.md" />
{% endif %}

{% if product %}
  <link rel="alternate" type="text/markdown" href="https://read.yourdomain.com/{{ product.handle }}.md" />
{% endif %}

Verification

  • Open article, page, and product source where relevant.
  • Confirm each page only renders the matching `alternate` tag.
  • Check that the handle Legible expects matches the Shopify handle you output.