Ajuda
Fazer login

Encontrar o ID de uma variante

Os IDs da variante às vezes são necessários para fazer personalizações no código do tema que se aplicam a variantes de produto específicas, ou para conciliar informações de migração ou de atualização de produtos em massa com um app de terceiros. Se precisar encontrar um ID da variante, você pode fazer isso no admin da Shopify.

Nesta página

Encontrar o ID da variante de um produto com variantes

Se um produto tiver variantes, como cores, tamanhos ou estilos diferentes, o ID da variante será exibido na barra de endereço do navegador como parte do URL. Essa pode ser uma forma rápida de encontrar o ID de uma variante individual.

Etapas:

  1. No admin da Shopify, acesse Produtos.

  2. Clique em um produto que tenha uma variante.

  3. Na seção Variantes, clique na variante do produto cujo ID você quer ver.

  4. Analise o URL na barra de endereço do navegador. O URL será semelhante ao exemplo a seguir:

https://admin.shopify.com/store/shopname/products/1234567/variants/36485954240671

O número depois de /variants/ é o ID da variante. Neste exemplo, o ID da variante é 36485954240671.

Encontrar o ID da variante de um produto sem variantes

Um produto que não tem variantes ainda assim tem um ID da variante atribuído. No entanto, diferente de um produto com variantes, o ID da variante não aparece na barra de endereço do navegador ao acessar a página de informações do produto no admin da Shopify.

É possível acessar o ID da variante de um produto exibindo as informações completas do produto em formato JSON. Essa pode ser uma forma rápida de encontrar o ID da variante de um produto individual.

Para facilitar a leitura da formatação JSON, instale uma extensão de visualização de JSON no navegador ou use a funcionalidade Pretty-print, disponível por padrão na maioria dos navegadores modernos.

Etapas:

  1. No admin da Shopify, acesse Produtos.

  2. Clique no produto cujo ID da variante você quer encontrar para abrir a respectiva página de informações.

  3. Na barra de endereço do navegador, adicione .json ao final do URL e pressione Enter para recarregar a página em JSON.

  4. Opcional: caso não tenha uma extensão de visualização de JSON instalada, ative a configuração Pretty-print na página da web para reformatar o arquivo JSON e deixá-lo mais fácil de ler.

  5. Localize o valor "product" > "variants" > "id". O início do arquivo JSON será exibido de forma semelhante ao exemplo a seguir:

{
  "product": {
    "id": 12345678901234,
    "title": "Example Product",
    "body_html": "<p>This is an example product.</p>",
    "vendor": "Example Vendor",
    "product_type": "Test Items",
    "created_at": "2025-07-09T12:40:46-04:00",
    "handle": "example-product",
    "updated_at": "2025-07-09T12:40:50-04:00",
    "published_at": "2025-07-09T12:40:47-04:00",
    "template_suffix": "",
    "published_scope": "global",
    "tags": "demo, test",
    "status": "active",
    "admin_graphql_api_id": "gid://shopify/Product/12345678901234",
    "variants": [
      {
        "id": 11223344556677,
        "product_id": 12345678901234,
        "title": "Default Title",
        "price": "30.00",
......}
.....]
....}
...}

No exemplo acima, 11223344556677 é o ID da variante do produto.

Exibir IDs da variante em massa em um relatório de estoque personalizado

A dimensão ID da variante do produto está disponível para uso em explorações de dados personalizadas. Essa pode ser uma maneira útil de exibir os IDs da variante de vários produtos em um único relatório, que pode ser salvo, impresso ou exportado. Essa exploração de dados inclui todos os produtos por padrão, inclusive os que são rascunhos, mas é possível filtrar o relatório para exibir apenas um subconjunto de produtos.

Saiba mais sobre como criar explorações de dados personalizadas.

Etapas:

  1. No admin da Shopify, acesse Análise > Relatórios.

  2. Clique em Nova exploração.

  3. No menu Métricas, aplique a métrica principal:

    1. Clique em ⊕.
    2. Selecione Porcentagem de estoque vendido.
    3. Clique em Aplicar.

  4. No menu Dimensões, aplique as dimensões necessárias:

    1. Clique em ⊕.
    2. Selecione Título do produto, Título da variante do produto e ID da variante do produto.
    3. Clique em Aplicar.

  5. Opcional: no menu Filtros, aplique filtros para exibir um subconjunto de produtos:

    • Para exibir apenas produtos sem variantes, aplique o filtro Título da variante do produto > é > Default Title.
    • Para exibir apenas produtos com variantes, aplique o filtro Título da variante do produto > não é > Default Title.

  6. Opcional: para salvar essa exploração de dados como um relatório personalizado para uso posterior, siga estas etapas:

    1. Clique em Salvar.
    2. Na caixa de diálogo Salvar relatório, dê um nome ao relatório personalizado, como Lista de produtos com IDs da variante.
    3. Clique em Salvar.

  7. Opcional: para exportar esta exploração de dados, clique em Menu > Exportar. Selecione o formato de arquivo de exportação de sua preferência e clique em Exportar.

Agora você pode ler e registrar os IDs da variante de todos os produtos exibidos no relatório.