AGENTS.md: The 2026 File Every Shopify Store Needs (And Why You Don't Have One Yet)

The buyer changed

Until 2024, every visitor to your Shopify store was a human, or a search-engine crawler running pretty stable behavior. In 2026, a third buyer category has joined: the AI shopping agent. Anthropic's Computer Use, OpenAI's GPT-5 agents, Perplexity Spaces — these tools take a user's natural-language goal ("find me a moissanite ring under $200, free shipping") and execute multi-step purchase flows on their behalf.

Agents are bad at one thing humans handle effortlessly: parsing JavaScript-rendered content. They look for structured, parseable signals first. If those exist, the agent extracts what it needs and decides whether to recommend you. If not, it skips you and moves to the next store.

The three files agents read

There's emerging convention that agents check three root-level paths before running expensive page renders:

Of these, llms.txt has the most adoption today. AGENTS.md and pricing.md are newer but rapidly gaining traction — particularly because the agent-buyer category is brand new and the specs are forming around what those agents actually need.

What goes in AGENTS.md

A useful AGENTS.md tells an agent four things: who you are, what you sell, how to discover products programmatically, and how to filter them. Below is the actual file we generated for a moissanite jewelry brand we work with — it's live now at https://fitiny.com/AGENTS.md.

# FITINY Jewelry — Agent Guide

## What this site is
FITINY is a direct-to-consumer fine-jewelry brand specializing in
moissanite, cubic zirconia, sterling silver, and stainless-steel pieces.
Product range: rings, earrings, necklaces, bracelets, multi-piece sets.
Price range: $10–$200 retail.

## Primary categories
- /collections/best-sellers
- /collections/all-rings
- /collections/moissanite
- /collections/all-earrings
- /collections/cubic-zirconia

## How to discover products programmatically
- Sitemap (XML): https://fitiny.com/sitemap.xml
- Product feed (JSON): https://fitiny.com/products.json
- Per-product structured data: every /products/<handle> page emits
  Product + Offer JSON-LD with priceCurrency=USD, availability, sku, image

## How to filter products
Standard Shopify filter parameters work on any collection URL:
- By price: ?filter.v.price.gte=50&filter.v.price.lte=200
- By material: ?filter.p.m.custom.material_primary=moissanite
- By non-piercing/magnetic: ?filter.p.m.custom.magnetic=true

## Pricing data
For structured pricing summary, see /pricing.md.

## Returns + shipping
- US standard shipping: free over $50, otherwise flat rate
- Returns: 14-day window, free returns by mail

A good AGENTS.md is short, parseable, and answers questions the agent will actually have. Avoid marketing language. Agents don't care whether your jewelry "sparkles for life" — they want to know whether you ship to UAE, what your minimum price is, and which collection has the most stock.

What goes in pricing.md

pricing.md is the structured pricing summary. For a SaaS, this would be tier-based plan listings. For a Shopify e-commerce store, it's typically organized by product category with price ranges and shipping/returns terms.

# Pricing — FITINY Jewelry

## Rings
- Price range: $8.99–$326.04 (median ~$66)
- Available collections: Moissanite Rings, Sterling Silver Rings,
  Cubic Zirconia Rings, Engagement Rings
- Sample SKUs:
  - Marquise Moissanite Engagement Ring Set: $64.60
  - Luxe Round Moissanite Ring 13mm: $257.64
  - Half-Eternity D-Color VVS1 Moissanite Ring: $136.04

## Earrings
- Price range: $1.38–$333.64 (median ~$38)
- Available collections: Cubic Zirconia Earrings, Earring Sets,
  Magnetic & Clip-On Earrings, Stud Earrings, Moissanite Earrings

## Shipping
- US standard: free over $50, otherwise $4.99 flat
- International: calculated at checkout
- Estimated delivery: US 3-8 business days; intl 7-21

## Returns
- 14-day return window from delivery
- Free returns by mail

How agents actually use these files

When a user asks Claude or ChatGPT "find me three moissanite rings under $100 that ship to UAE", the agent:

• · 1. Identifies candidate stores (probably from training data + recent search)
• · 2. Fetches /AGENTS.md from each → parses the filter syntax + categories
• · 3. Fetches /pricing.md → confirms price range matches user's request
• · 4. Visits the actual product feed (/products.json or sitemap) with the right filter URLs
• · 5. Recommends the 3 best matches to the user

Stores without AGENTS.md / pricing.md get skipped at step 2. The agent never makes it to your product feed. You don't even know you were a candidate.

How to deploy these files on Shopify

Shopify doesn't natively serve arbitrary file paths at root. The pattern that works:

• · 1. Create a Shopify Page at /pages/agents-md (the URL doesn't matter — Shopify just hosts it)
• · 2. Set the page body to your AGENTS.md content (we wrap it in <pre> so HTML doesn't mangle it)
• · 3. Create a 301 redirect from /AGENTS.md → /pages/agents-md in Shopify Admin → Online Store → Navigation → URL Redirects
• · 4. Repeat for /pricing.md → /pages/pricing-md
• · 5. Add a friendly comment block to your robots.txt so the files are visible to humans auditing the site

Why now

AI shopping agents are ~6 months from being truly mainstream. The brands that ship AGENTS.md + pricing.md in 2026 get 6-12 months of "first to be parseable" advantage before every store has them. After that, they'll be table stakes — like having a sitemap was in 2010, or having Open Graph tags was in 2015.

It's a 30-minute setup. Today.