---
title: Routes
description: Every URL in the storefront and its purpose.
type: reference
---

# Routes



## Pages

| Route                                 | Description                                                   |
| ------------------------------------- | ------------------------------------------------------------- |
| `/`                                   | Home page                                                     |
| `/products/[handle]`                  | Product detail page; option query parameters select a variant |
| `/collections`                        | Collection index                                              |
| `/collections/[handle]`               | Collection listing with filters, sorting, and pagination      |
| `/collections/all`                    | All-products listing                                          |
| `/search`                             | Product search results                                        |
| `/cart`                               | Cart and related products                                     |
| `/blogs/[blogHandle]`                 | Shopify blog listing                                          |
| `/blogs/[blogHandle]/[articleHandle]` | Shopify article                                               |
| `/pages/[handle]`                     | Shopify page                                                  |
| `/policies/[handle]`                  | Shopify store policy                                          |

## API routes

| Route                        | Description                                    |
| ---------------------------- | ---------------------------------------------- |
| `POST /api/webhooks/shopify` | Shopify webhook handler for cache invalidation |
| `POST /api/chat`             | Shopping-assistant stream                      |

## Variant URLs

Product options use one query parameter per option. The key is the lowercased option name and the value is the selected option value.

For example, `/products/your-product?color=Blue&size=XS` selects the blue, extra-small variant. Without option parameters, the page selects the first available variant.


---

For a semantic overview of all documentation, see [/sitemap.md](/sitemap.md)

For an index of all available documentation, see [/llms.txt](/llms.txt)

For agent-facing discovery, including API and MCP surfaces, see [/agents.md](/agents.md)