# products O Objeto `products` é um array que disponibiliza informações de todos os produtos possíveis na página atual. Na pagina de categorias “catalog”, por exemplo contém somente os produtos da categoria determinada de acordo com os filtros aplicados, e na “search” contém os produtos de acordo com os critérios da busca e os filtros aplicados. Para chamar produtos com critérios personalizados, veja a função [Products()](/themes/construindo-seu-template/referencias/funcoes/products.md). {% hint style="warning" %} **Disponível para uso nas páginas:** home | catalog | search {% endhint %} {% hint style="info" %} **Para saber mais sobre como gerenciar produtos acesse:** [Cadastrar Produto](https://basedeconhecimento.tray.com.br/hc/pt-br/articles/6732451110171-Cadastrar-Produto) {% endhint %} ### Atributos disponíveis​ As requisições de produtos sempre retornarão um array de dados, portanto podem ser exibidos com a utilização de um índice determinado como nos atributos abaixo, ou quando iterados em um laço de repetição. | Atributos | Característica | | | | | | | | | | | | | | | ----------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --- | ----------- | ----- | ----- | -------------- | --------- | ---------------- | ------------ | -------------- | --------------- | ------------------- | --- | ---------------------------- | | `{{ products[0].id }}` | Identificador único do produto. | | | | | | | | | | | | | | | `{{ products[0].name }}` | Nome do produto. | | | | | | | | | | | | | | | `{{ products[0].description_small }}` | Retorna um texto com a uma descrição [simplificada do produto.](https://basedeconhecimento.tray.com.br/hc/pt-br/articles/7114185489691-SEO-Otimiza%C3%A7%C3%A3o-de-Busca-por-Produto) | | | | | | | | | | | | | | | `{{ products[0].category_id }}` | Identificador único da Categoria Principal do Produto | | | | | | | | | | | | | | | `{{ products[0].price }}` | Exibe o valor de venda configurado no produto. | | | | | | | | | | | | | | | `{{ products[0].start_promotion }}` | Exibe a data de inicio da promoção do produto. | | | | | | | | | | | | | | | `{{ products[0].end_promotion }}` | Exibe a data de término da promoção do produto. | | | | | | | | | | | | | | | `{{ products[0].brand }}` | Exibe a marca do produto. | | | | | | | | | | | | | | | `{{ products[0].model}}` | Exibe o modelo do produto. | | | | | | | | | | | | | | | `{{ products[0].weight }}` | Exibe o peso do produto em gramas. | | | | | | | | | | | | | | | `{{ products[0].length }}` | Exibe o comprimento do produto em centímetros. | | | | | | | | | | | | | | | `{{ products[0].width }}` | Exibe a largura do produto em centímetros. | | | | | | | | | | | | | | | `{{ products[0].height }}` | Exibe a altura do produto em centímetros. | | | | | | | | | | | | | | | `{{ products[0].reference }}` | Exibe o código de Referência do produto. | | | | | | | | | | | | | | | `{{ products[0].quantity_sold }}` | Exibe a quantidade de produtos vendidos. | | | | | | | | | | | | | | | `{{ products[0].price_offer }}` | Exibe o preço em promoção do produto. | | | | | | | | | | | | | | | `{{ products[0].show_price }}` |

Existem regras na plataforma referente a exibição do preço.
Só exiba o preço se o show\_price for verdadeiro

| | | | | | | | | | | | | | | `{% if products[0].has_other_prices %}` | Retorna se o produto possui outros preços | | | | | | | | | | | | | | | `{{ products[0].has_variation }}` | Retorna o valor **1** caso o produto possua variações. | | | | | | | | | | | | | | | `{{ product.variants }}` |

Retorna um array com todas as informações das variações, os índices retornados são:

id | ean | product\_id | price | stock | minimum\_stock | reference | start\_promotion | VariantImage | end\_promotion | payment\_option | illustrative\_image | Sku | payment\_option\_details

| | `{{ products[0].payment }}` | Retorna opões de parcelamento do produto | | | | | | | | | | | | | | | `{{ products[0].link }}` | Link para a página do produto | | | | | | | | | | | | | | | `{{ products[0].upon_request }}` | Retorna se o produto está sob consulta | | | | | | | | | | | | | | | `{{ products[0].available }}` | Retorna um valor booleano. Caso o produto esteja ativo para venda, exibe o valor **1**. A opção "Produto ativo - será exibido na loja para venda" no cadastro do produto tem que estar setada. | | | | | | | | | | | | | | | `{{ products[0].availability }}` | Retorna o [Prazo de disponibilidade](https://basedeconhecimento.tray.com.br/hc/pt-br/articles/6735743602203-Prazo-de-Disponibilidade-para-Produtos) configurado para o produto. | | | | | | | | | | | | | | | `{{ products[0].stock }}` | Quantidade de produtos em estoque. | | | | | | | | | | | | | | | `{% if products[0].featured %}` | Retorna verdadeiro se for destaque | | | | | | | | | | | | | | | `{% if products[0].new %}` | Retorna verdadeiro se for lançamento | | | | | | | | | | | | | | | `{% if products[0].free_shipping %}` | Retorna verdadeiro se possuir frete grátis | | | | | | | | | | | | | | | `{{ products[0].additional_button }}` | Retorna o valor **1** caso o produto **não** necessite de alguma seleção adicional para comprar. Não retornará nenhum valor para produtos com variação, kit, entre outros que necessitem de ação adicional antes de comprar. | | | | | | | | | | | | | | | `{{ products[0].additional_message }}` | Exibe a mensagem adicional cadastrada do produto. | | | | | | | | | | | | | | | `{% set ranking = products[0].ranking %}` | count \| rating Ranking (avaliação) do produto | | | | | | | | | | | | | | | `{{ products[0].warranty }}` | Exibe a opção selecionada no tempo de garantia do produto. | | | | | | | | | | | | | | | `{{ product.bonus_html }}` | [Programa de fidelização](https://basedeconhecimento.tray.com.br/hc/pt-br/articles/6743361546011-Programa-de-Fidelidade) | | | | | | | | | | | | | | | `{{ product.data_tray_ga4 }}` | [Atributo para o Google Analytics 4](/themes/construindo-seu-template/desenvolver/atributo-google-analytics-4.md) | | | | | | | | | | | | | | ### Atributo **`product.images`** Este atributo retorna um array com informações sobre as imagens cadastradas no produto, que pode ser usado nas páginas home, catalog e search. É possível manipular o tamanho da imagem para uso em Thumbnails por exemplo, com os atributos da tabela abaixo:
Atributos disponíveis do "product.images"Características e Exemplo de uso
small​

Exibe a imagem do produto nas dimensões de 30x30px. Exemplo de código:

{% set images = products[0].images %}
<img src="{{ images[0].small }}" alt="">
medium

Exibe a imagem do produto nas dimensões de 90x90px. Exemplo de código:

{% set images = products[0].images %}
<img src="{{ images[0].medium }}" alt="">
large

Exibe a imagem do produto nas dimensões de 180x180px. Exemplo de código:

{% set images = products[0].images %}
<img src="{{ images[0].large }}" alt="">
full

Exibe a imagem do produto no tamanho original dela. Exemplo de código:

{% set images = products[0].images %}
  <img src="{{ images[0].full }}" alt="">
### Como Usar Abaixo você pode ver alguns exemplos da utilização do Objeto `products` {% code title="Input" %} ```html
``` {% endcode %} {% code title="Output" %} ```html
``` {% endcode %} --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://partners.tray.com.br/themes/construindo-seu-template/referencias/objetos/products.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.