Customizing AI-Facing Info on Your Shopify Store with agents.md.liquid

On May 29, 2026, Shopify released the ability to customize /agents.md, /llms.txt, and /llms-full.txt. These files act as an "instruction sheet" that AI agents (ChatGPT, Claude, Copilot, and so on) use to retrieve information about your store.

Shopify generates them automatically without any setup on your part, but you can now fully customize them through Liquid templates in your theme.

How the templates are resolved

Each of the three files can have its own dedicated template, but if one is missing it falls back to agents.md.liquid.

/agents.md      → agents.md.liquid      → Shopify auto-generated
/llms.txt       → llms.txt.liquid       → agents.md.liquid → Shopify auto-generated
/llms-full.txt  → llms-full.txt.liquid  → agents.md.liquid → Shopify auto-generated

In other words, creating a single agents.md.liquid applies to all three files. You only add the dedicated templates when you want each file to have different content.

What gets served by default

Even with no customization at all, Shopify automatically generates information like the following.

# Agent Instructions — HOGEHOGE

This document describes how AI agents can interact with
the online store at https://hogehoge.jp.

## Commerce Protocol (UCP)

For AI agents that support commerce protocols, this store uses
Unified Commerce Protocol (UCP).

- Discovery: GET https://hogehoge.jp/.well-known/ucp
- MCP endpoint: POST https://hogehoge.jp/api/ucp/mcp

## Agent Flow

1. Discover → 2. Search → 3. Cart → 4. Checkout → 5. Complete

## Read-Only Browsing

- /collections/all — all products
- /products/{handle}.json — product details
- /policies/shipping-policy — shipping policy
...

It includes a pointer to the Shop skill (shop.app/SKILL.md), the UCP endpoints, a typical agent flow, and read-only browsing information. The key point is that you get all of this without doing anything.

When customization is worth it

You'd customize in cases like these.

• You want to add your own business information (hours of operation, supported languages, special notes)
• You want AI to preferentially recommend specific collections or products
• You want a clear separation between a short version and a detailed version

How to customize

Step 1: Create the template

In the theme editor, create a new file at templates/agents.md.liquid.

Step 2: Use the agents object

Liquid's agents object lets you output information dynamically.

Concrete code examples

Basic customization (agents.md.liquid)

# Agent Instructions — {{ agents.store_name }}

This document describes how AI agents can interact with
the online store at {{ agents.store_url }}.

## Commerce Protocol (UCP)

- Discovery: `GET {{ agents.ucp_discovery_url }}`
- MCP endpoint: `POST {{ agents.mcp_endpoint_url }}`

### Supported UCP versions
{% for version in agents.ucp_versions %}
- {{ version }}{% if forloop.first %} (latest stable){% endif %}
{% endfor %}

## Information specific to our store

- Hours: 10:00-18:00 (closed weekends and holidays)
- Supported languages: Japanese, English
- Notes: Gift wrapping available, business discounts offered

Splitting out the short version (llms.txt.liquid)

# {{ agents.store_name }}

> Summary for agents. See {{ agents.store_url }}/agents.md for details.

- UCP discovery: {{ agents.ucp_discovery_url }}
- MCP endpoint: {{ agents.mcp_endpoint_url }}
- Sitemap: {{ agents.sitemap_url }}

Splitting out the detailed version (llms-full.txt.liquid)

# {{ agents.store_name }} — Full Agent Reference

In addition to the contents of {{ agents.store_url }}/agents.md,
this file provides the following supplementary information.

## Commerce Protocol (UCP)
- Discovery: {{ agents.ucp_discovery_url }}
- MCP endpoint: {{ agents.mcp_endpoint_url }}

## Popular categories
{% for collection in collections limit:5 %}
- [{{ collection.title }}]({{ shop.url }}{{ collection.url }})
{% endfor %}

## Recent blog posts
{% for article in blogs.news.articles limit:3 %}
- [{{ article.title }}]({{ shop.url }}{{ article.url }})
{% endfor %}

Things to watch out for

• Don't output information you don't want scraped, such as contact email addresses or phone numbers
• Don't hardcode URLs; generate them dynamically with the agents object (so they keep working through future changes)
• When testing, check directly with curl: curl https://your-store.com/agents.md

Summary

• 99% of stores can do nothing and be fine (Shopify's defaults are solid)
• If you want to customize, just edit agents.md.liquid and it applies to all three files
• Only add llms.txt.liquid / llms-full.txt.liquid when you want to split out a short version and a detailed version

Reference links

• Changelog: Customize llms.txt, llms-full.txt, and agents.md
• agents.md.liquid documentation
• llms.txt standard
• UCP specification