Pular para o conteúdo principal
Estas variáveis existem em todas as páginas. Algumas só têm dados em certas rotas (indicado em cada uma); cada página também recebe variáveis próprias (ver Páginas).
Campos sem valor costumam vir ausentes ou null. Teste antes de usar: {% if store.custom_domain %}…{% endif %}.

store: a loja

Existe também shop (name, slug, id, logo_url, banner_url). Prefira store, que traz os dados completos.

theme: aparência

Campos que o dono não configurou ficam ausentes.
theme.logo vem em tamanho pequeno (64 px). Para mostrar o logo grande, use um campo de imagem do schema.

config e settings

config junta, nesta ordem (o seguinte vence o anterior): a paleta do tema, as seções da home e os valores do schema. A chave em config é exatamente a chave do campo no schema — use só letras, números e _ (primary_color). Quando o tema tem o próprio config/settings_schema.json, settings traz os valores já validados: chaves não declaradas são descartadas e os default preenchidos. Sem esse arquivo (como no Vega), settings traz os valores salvos como estão — sem default. Os termos da loja também ficam em settings.terms_content quando o tema não define esse campo.
Imagens do schema já chegam como URL pronta — não passe por cdn_url.

user, customer, logged_in

user/customer são null sem login; email e discord_id ficam ausentes quando vazios.

categories e category

categories é a árvore de categorias (2 níveis); category é a categoria atual na página de coleção.
Se houver produtos sem categoria, aparece no fim uma categoria “Todos” (slug: "todos").

Produtos: products, packages, product

  • products — lista de produtos (cards).
  • packages — envelope { data: [...], size, total } com a mesma lista.
  • product / package — o produto da página de produto (mesmo objeto).
Com dados em: home, /products e busca (até 100 produtos) e coleção (até 50), sem paginação no servidor. Card de produto (products, packages.data, category.products): Produto completo (product / package, só na página de produto) — tudo do card, mais:

socials e gateways

  • socials — todas as redes, null quando não configurada: instagram, discord, youtube, twitter, facebook, tiktok, whatsapp, telegram.
  • gateways — métodos de pagamento disponíveis agora na loja. Campos: name (PIX ou CREDITCARD), display, method, provider, fee, fee_percent, fee_fixed, is_percentage_fee, require_document, require_address, require_phone, max_installments.

Rotas específicas

order: status (APPROVED, PENDING, REJECTED, CANCELED, REFUNDED, CHARGEDBACK), price, price_display, gateway, gateway_display, pix_code, qr_code (imagem SVG em data-URI), packages[], deliveries[], client_name, client_email, promo_code, created_at, access_token. posts: { data, meta }, com meta = total, per_page, current_page, last_page, first_page, next_page_url, previous_page_url. post: title, slug, content (HTML), image, excerpt, author, reading_time, published_at (data por extenso, pt-BR) e published_at_iso.

Requisição

  • query — parâmetros da URL (query.page, …; o primeiro valor de cada chave).
  • pathname — o caminho canônico da página (ex.: /collections/x mesmo que o visitante tenha aberto /category/x; /404 na página de erro).

Scripts e estilos da plataforma

O SDK da AllBay é injetado automaticamente em toda página. Se quiser controlar a posição:
Para o CSS do Tailwind do tema, use a tag {% tailwindcss %}.