> ## Documentation Index
> Fetch the complete documentation index at: https://allbay.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Páginas próprias (custom)

> Crie páginas novas na loja, como Sobre, FAQ, landing ou todas as categorias: um arquivo em pages/ vira /pages/nome.

Além das páginas da plataforma (home, produto, categoria, carrinho…), o tema pode ter **páginas próprias**.
Cada arquivo `pages/<nome>.liquid` vira a página `/pages/<nome>` da loja.

Use para: Sobre, FAQ, política de troca, landing de campanha, página com **todas as categorias**,
página de um jogo ou de uma coleção especial, e o que mais o tema precisar.

## Como criar

**1. Tenha uma cópia própria do tema**

No painel, em **Aparência**, use **Personalizar** no tema. Uma loja que usa o tema direto da
galeria não tem onde guardar arquivos novos: sem a cópia, a página não existe.

**2. Crie o arquivo em pages/**

Por exemplo `pages/sobre.liquid`, pelo editor do painel ou pelo [Editor Local](https://allbay.mintlify.site/editor/editor-local.md).

**3. Publique**

A página fica em `https://sua-loja/pages/sobre`.

**4. Ponha um link para ela**

Ninguém encontra a página sozinho: adicione um link no menu, no rodapé ou num botão do tema.

## Regras do nome

| Regra | Certo | Errado |
| - | - | - |
| Minúsculas, números, `-` e `_`; começa com letra ou número | `politica-de-troca` | `Politica de Troca`, `-sobre` |
| Sem ponto no nome | `faq-2025` | `faq.2025` |
| Direto em `pages/`, um nível só | `pages/jogos.liquid` | `pages/jogos/roblox.liquid` |
| Não usar nome de página da plataforma | `pages/sobre.liquid` | `pages/index.liquid` (ver abaixo) |

A URL é **sempre** `/pages/<nome>`:

| Arquivo | URL | Funciona? |
| - | - | - |
| `pages/sobre.liquid` | `/pages/sobre` | Sim |
| `pages/sobre.liquid` | `/sobre` | Não: 404 |
| `pages/a/b.liquid` | `/pages/a/b` | Não: o editor não aceita subpasta, e a rota dá 404 |

> [!WARNING]
>
> Não crie página própria com o nome de uma página da plataforma: `index`, `package`, `product`,
> `category`, `collection`, `checkout`, `cart`, `search`, `terms`, `blog`, `post`, `order`,
> `payment`, `login`, `account`, `maintenance`, `not-found`, `404`. Esses arquivos já são as
> páginas da loja (ver [Páginas](https://allbay.mintlify.site/editor/paginas.md)).

## O que a página recebe

* As [variáveis globais](https://allbay.mintlify.site/editor/variaveis-globais.md): `store`, `theme`, `config`, `settings`, `customer`,
  `logged_in`, `pathname`…
* **Nenhum dado próprio da rota.** Para produtos, categorias, avaliações ou posts, use
  [`{% load %}`](https://allbay.mintlify.site/editor/tags#load-dados-dinâmicos) na própria página (até 20 por página).

## Layout

Comece a página declarando o layout, como as outras páginas do tema:

```liquid theme={null}
{% layout "layouts/layout", page_title: 'Sobre' %}
```

Se o tema usa `{% layout %}` e a página não declara, ela sai sem `<html>`/`<head>`, só como
fragmento. Ver [Layouts](https://allbay.mintlify.site/editor/paginas.md#layouts).

## Exemplo: página com todas as categorias

`pages/jogos.liquid`:

```liquid theme={null}
{% layout "layouts/layout", page_title: 'Todos os jogos' %}
{% load "categories", limit: 50 %}

<section>
  <h1>Todos os jogos</h1>
  <div class="grid">
    {% for category in categories %}
      {% if category.hide_category != true %}
        <a href="/collections/{{ category.slug | default: category.id }}">
          {% if category.image %}<img src="{{ category.image }}" alt="" loading="lazy">{% endif %}
          <span>{{ category.name }}</span>
        </a>
      {% endif %}
    {% endfor %}
  </div>
</section>
```

E o botão da home:

```liquid theme={null}
<a href="/pages/jogos">Ver todos os jogos</a>
```

`load "categories"` traz até 50 categorias principais, com as subcategorias em `sub_categories`.

## Buscadores (SEO)

* A página é indexável e tem link canônico para ela mesma.
* Ela **não entra** no `sitemap.xml` da loja: os buscadores a encontram pelos links do tema.

## Página deu 404?

1. O tema publicado é uma **cópia própria** e tem o arquivo? O que vale é o **publicado**, não o rascunho.
2. A URL tem o `/pages/`? `/sobre` não existe; o certo é `/pages/sobre`.
3. O nome segue as regras acima (minúsculas, sem ponto, sem subpasta)?


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.