Dois jeitos de capturar a personalização
O Shopify é dono da loja e do checkout, então o input é adicionado por mecanismos nativos do Shopify. Escolha um caminho.
- Propriedade de item de linha — um campo personalizado na página do produto. Funciona em todo plano do Shopify. Requer uma pequena edição de tema.
- Extensão de UI de checkout — um bloco personalizado renderizado dentro do checkout. Apenas Shopify Plus. Sem edição de tema, mas um desenvolvedor implanta um app personalizado.
Os dois métodos produzem o mesmo resultado: uma propriedade vinculada ao item de linha. Desde que se chame Customization Request, o Alva extrai o valor automaticamente.
Método 1 — Propriedade de item de linha
1. Abra o template do produto
No admin Shopify, vá em Loja Online → Temas, clique em Editar código e abra sections/main-product.liquid (ou product-template.liquid em temas mais antigos).
Editor de código do tema Shopify. Mostre a árvore de arquivos à esquerda com main-product.liquid destacado, e o arquivo Liquid aberto à direita rolado até o bloco do formulário de produto. Sem dados reais da loja visíveis.
2. Adicione o input dentro do form do produto
Dentro do bloco {% form 'product' %}, adicione um label e um input de texto. O atributo name deve usar a sintaxe de colchetes properties[Customization Request] — isso diz ao Shopify para vincular o valor ao item de linha.
<label for="customization">Personalisation request</label>
<input type="text"
id="customization"
name="properties[Customization Request]"
maxlength="200"
required>3. Defina restrições de obrigatoriedade e tamanho
Adicione required para que os clientes não possam deixar em branco, e maxlength="200" para que não colem um parágrafo. Mantenha o label concreto — Nome para bordar ganha de Personalização.
4. Salve e faça um pedido de teste
Salve o template, veja o produto na loja, preencha o input e faça um pedido de teste. O valor aparece no Shopify em Pedido → Itens de linha e dentro do Alva na página de detalhes do pedido personalizado.
Uma página de produto na loja com o input de personalização renderizado acima do botão Adicionar ao carrinho. Campo rotulado "Nome para bordar" com um exemplo placeholder. Sem necessidade de marca real da loja.
Método 2 — Extensão de UI de checkout
Lojistas Plus podem renderizar o input dentro do próprio checkout. O Alva Digital Downloads não envia essa extensão — construí-la é tarefa de um desenvolvedor Shopify. Veja a referência de extensões de UI de checkout do Shopify para a API atual.
1. Faça scaffold de uma extensão
A partir de um app Shopify personalizado, rode shopify app generate extension e escolha Checkout UI extension. Pegue o target purchase.checkout.block.render.
2. Escreva a propriedade de item de linha
Use a API de propriedade de item de linha de @shopify/ui-extensions-react/checkout para vincular o valor ao item de linha sob a chave Customization Request.
3. Implante e posicione o bloco
Rode shopify app deploy, depois em Configurações → Checkout → Personalizar, solte o novo bloco no layout e faça um pedido de teste.
Onde o valor aparece no Alva
Quando o Shopify dispara o webhook orders/paid, o Alva lê qualquer propriedade de item de linha chamada exatamente Customization Request e a guarda contra a compra. A página de detalhes do pedido personalizado renderiza o valor acima do uploader de arquivo, e o mesmo texto é incluído no e-mail de notificação ao lojista.
FAQ
Posso tornar o campo de personalização obrigatório?
Sim. Adicione o atributo HTML required. O Shopify bloqueia Adicionar ao carrinho até o campo ter um valor. O método de extensão de UI de checkout expõe uma opção required nas configurações da extensão.
Posso capturar mais de um input por produto?
Sim, mas o Alva só extrai automaticamente a propriedade chamada Customization Request. Outras propriedades de item de linha ainda aparecem no pedido Shopify e ficam visíveis dentro do Alva na página de detalhes do pedido.
O cliente pode editar o input após o pedido ser pago?
Não. Propriedades de item de linha são imutáveis uma vez que o pedido é feito. Se uma correção for necessária, peça ao cliente para enviá-la por e-mail e atualize as notas do pedido manualmente antes de fazer upload do arquivo.
Veja também
Foi útil?
Última atualização 2026-05-06