Aprenda a usar campos personalizados para melhorar a experiência de compra no seu e-commerce.
Última atualização: 03/11/2026
Os campos personalizados permitem que você atribua diferentes atributos às suas vendas e produtos no painel da sua Nuvemshop, facilitando a gestão interna dos seus pedidos e catálogo de produtos.
É assim que serão exibidos os campos personalizados dentro do pedido:
Importante
Esta funcionalidade está disponível a partir do plano Escala.
A seguir, te mostramos como configurar e utilizar campos personalizados em sua loja.
Criar campos personalizados
1. Acessar o painel administrador Nuvemshop.
2. Seguir pelo caminho "Configurações > Campos personalizados".
3. Selecionar a seção em que você quer criar o campo personalizado: Categorias, Clientes, Produtos, Variantes de produtos ou Vendas.
4. Clicar em "Criar campo".
5. Na nova tela que se abre, em "Atributos", escolher o tipo em "Tipo de campo".
Importante
Para alguns tipos de campo, o painel mostra "Padrões sugeridos", como "Gênero" para o tipo Lista de opções. São campos com uma estrutura definida pela Nuvemshop, iguais em todas as lojas.
As opções de campo que você poderá criar dependem da seção em que estiver:
Texto livre: aceita dados em texto e números.
Data: permite definir uma data em um calendário.
Lista de opções: permite criar uma lista de valores para que você possa selecionar em uma lista suspensa.
Numérico: aceita dados em formato numérico.
Texto livre: aceita dados em texto e números.
Data: permite definir uma data em um calendário.
Lista de opções: permite criar uma lista de valores para que você possa selecionar em uma lista suspensa.
Numérico: aceita dados em formato numérico.
Verdadeiro/Falso: permite responder sim ou não.
Cor: permite escolher uma cor.
Referência: vincula o campo a uma entrada de um metaobjeto.
Lista de referências: vincula o campo a várias entradas de um metaobjeto.
Objeto: guarda um conjunto estruturado de valores.
Lista de objetos: guarda vários conjuntos estruturados de valores.
JSON: guarda dados em formato técnico, usado principalmente por aplicativos e desenvolvedores.
Dica
Somente os campos personalizados de variantes de produtos podem ser usados como filtros na loja. Ou seja, os campos que você criar para produtos não podem ser usados com essa finalidade.
6. Definir um nome para o seu campo personalizado (ex.: Etapa de produção, Etapa de preparação, Data comemorativa etc.).
7. O próximo passo dependerá do tipo de campo que você escolheu:
Se você escolheu "Lista de opções", preencher os valores da lista:
7.1. Nas configurações do campo personalizado, na seção Valores, clicar em "+ Adicionar valores".
7.2. Inserir os valores que serão relacionados ao campo (ex.: A produzir, A confeccionar, A estampar, Dia das crianças etc.).
7.3. Clicar em "Adicionar". Caso queira adicionar outros valores, clicar em "+ Novo valor".
Importante
Esses valores serão usados depois para atribuí-los às vendas, produtos, clientes ou categorias.
Além disso, você poderá adicionar uma descrição, que é uma nota informativa opcional, por exemplo, para explicar como usar esse campo.
Se você escolheu "Referência" ou "Lista de referências", primeiro é preciso criar um metaobjeto. Depois, em "Tipo de metaobjeto", escolher o metaobjeto que você quer vincular ao campo.
Se você escolheu "Objeto" ou "Lista de objetos", na seção "Esquema", escrever um rótulo para a propriedade, por exemplo "Cor", e escolher o tipo dela. Para adicionar outra propriedade, clicar em "Adicionar propriedade".
Se você escolheu outro tipo de campo (Texto livre, Data, Numérico, Verdadeiro/Falso, Cor ou JSON), será necessário preencher apenas o nome e a descrição, pois não é necessário adicionar nenhum valor. Depois, o valor é atribuído ao preencher cada produto, venda, cliente ou categoria.
8. Na seção "Capacidades", ativar as opções de que você precisar.
A seção "Capacidades" aparece ao criar campos de clientes, produtos e variantes de produtos. Os campos de categorias e vendas não têm essa seção. Estas são as opções disponíveis:
Editável no admin: exibe o campo no formulário da entidade no painel, para que você possa preenchê-lo. Sem essa opção, o valor só pode ser carregado por API.
Leitura pública: permite que a API pública, usada por aplicativos e integrações, leia o valor do campo.
Escrita pública: permite que a API pública modifique o valor do campo. É habilitada quando você ativa a leitura pública.
Filtro na loja: disponível apenas em variantes de produtos. Transforma o campo em um filtro da lista de produtos da sua loja.
Exibir no checkout: disponível apenas em clientes. Exibe o campo para que quem compra o preencha durante a compra. Você pode exibir até 2 campos, dos tipos Texto livre, Data, Lista de opções, Numérico ou Verdadeiro/Falso. A resposta de quem compra aparece no detalhe da venda. Para configurar, veja como pedir dados aos seus clientes no checkout com campos personalizados.
9. Por último, clicar em "Adicionar".
Dica
No momento, você pode adicionar mais valores a um campo personalizado já criado, mas não é possível excluir esses valores nem alterar o nome deles. Se precisar modificar algum valor, você deve excluir o campo e criá-lo novamente.
Pronto!
Utilizar os campos personalizados
Veja como usar os campos personalizados nas suas vendas ou produtos. Para preencher um campo de clientes, produtos ou variantes pelo painel, a opção "Editável no admin" precisa estar ativada.
Após a criação do campo personalizado para categorias (podendo ser do tipo Lista de opções, Número, Data e aberto), você pode incluir esses campos personalizados nessas categorias, igual o exemplo abaixo:
1. Para adicionar os campos personalizados nas categorias, seguir pelo caminho "Produtos > Categorias".
2. Uma vez dentro, você pode adicionar uma nova categoria ou subcategoria clicando em "+ Criar categoria" ou se já possui uma criada, clicar nos "três pontinhos > Editar".
3. Na próxima página, deslizar até a seção Campos personalizados, nela você irá encontrar todos os campos criados.
4. Ao finalizar, clicar em "Salvar".
Após a criação do campo personalizado para Clientes (podendo ser do tipo Lista de opções, Número, Data e aberto), você pode incluir esses campos personalizados no cadastro dos seus clientes, igual o exemplo abaixo:
1. Para adicionar os campos personalizados em um cadastro de cliente, seguir pelo caminho "Clientes > Lista de clientes".
2. Uma vez dentro, você pode adicionar um novo cadastro clicando em "+ Adicionar novo cliente" ou se já é cadastrado, procurar, acessar esse cadastro, nele você deve clicar em "Editar".
3. Na próxima página, deslizar até a seção Campos personalizados, nela você irá encontrar todos os campos criados.
4. Ao finalizar, clicar em "Salvar". Verá que as informações serão exibidas na seção Dados do cliente no perfil do cadastro.
Após criar os campos personalizados para os produtos que deseja usar, você pode aplicá-los em seus produtos. Caso o produto possua variações, deve-se aplicar o valor do campo personalizado em cada variante.
Para isso, vá em "Produtos> Lista de produtos":
Produto sem variação: acessar o produto que deseja incluir o valor, deslizar até a seção Campos personalizados, selecionar o valor e clicar em "Salvar alterações".
Produto com variação: acessar o produto que deseja incluir o valor, deslizar até a seção Variações, escolher a variação, clicar em "Editar variação", deslizar até a seção Campos personalizados, selecionar o valor e clicar em "Salvar alterações".
Em seguida, clicar em "Salvar alterações". No exemplo abaixo, mostramos como adicionar o campo personalizado em uma variação:
Importante
Esta opção está disponível apenas no plano Escala.
Para isso, vá em "Produtos> Lista de produtos", depois é só marcar os produtos que você deseja aplicar os campos personalizados.
Em seguida, irá abrir uma caixa para ação massiva, procurar e clicar em "Atribuir campos personalizados".
❗ Quando aplicar, você irá receber um e-mail de confirmação.
Importante
Se marcar um produto com variações, o campo personalizado será aplicado em todas as variantes.
No exemplo abaixo, mostramos como adicionar aplicar os campos personalizados de forma massiva.
Acesse a seção "Vendas > Lista de vendas" do seu painel. Depois, de acordo com o plano que você usa, é possível atribuí-los um por um ou em massa:
1. Clicar no número da venda à qual você quer atribuir o atributo para abrir os detalhes dela.
2. No detalhe da venda, ir até a seção "Campos personalizados".
3. Em cada campo configurado, selecionar o valor correspondente.
Dica
Esta funcionalidade está disponível a partir do plano Escala.
1. Selecionar as vendas às quais você quer aplicar o valor de um campo personalizado, marcando a caixa de cada uma ou usando o contador de vendas selecionadas. Você pode aplicar a ação em até 100 vendas por vez. Veja como selecioná-las em Como atualizar o status dos pedidos da minha Nuvemshop de forma massiva?
2. Abrir o menu "Mais ações".
3. Na seção "Campos personalizados", selecionar a opção "Atribuir campos".
4. No painel "Atribuir campos personalizados", que se abre à direita, selecionar o valor de cada campo que você quer atribuir. Na parte de cima, você vê quantas vendas selecionou.
Dica
Se uma venda já tem campos personalizados atribuídos, eles são substituídos pelos novos valores.
5. Clicar em "Atribuir campos".
Depois que os campos forem atribuídos às vendas, você vai receber um e-mail de confirmação.
Importante
Você pode atribuir atributos em campos diferentes dentro de um mesmo pedido.
Filtrar pelos campos personalizados
Após criar e aplicar campos personalizados às suas vendas ou produtos, você pode filtrar por esses campos da lista correspondente para facilitar a gestão.
No exemplo abaixo, filtramos a lista de produtos por um campo personalizado:
