Variáveis dinâmicas do certificado
variáveis são campos preenchidos automaticamente no certificado — nome, curso, data e outros dados do aluno e da turma.
O que são variáveis dinâmicas
Variáveis são marcadores de posição no template do certificado. Quando a evob gera o PDF, substitui cada variável pelo valor real do aluno naquele momento.
Exemplo:
| No template | No PDF gerado | |---|---| | `{{ aluno_nome }}` | Maria Silva | | `{{ curso_nome }}` | Coloração Avançada | | `{{ data_conclusao }}` | 5 de maio de 2026 |
Variáveis disponíveis
Dados do aluno
| Variável | O que exibe | |---|---| | `{{ aluno_nome }}` | Nome completo do aluno | | `{{ aluno_email }}` | E-mail do aluno | | `{{ aluno_documento }}` | CPF ou documento cadastrado |
Dados do curso e turma
| Variável | O que exibe | |---|---| | `{{ curso_nome }}` | Nome do curso | | `{{ turma_nome }}` | Nome da turma em que o aluno estava matriculado | | `{{ carga_horaria }}` | Carga horária definida nas informações do curso | | `{{ professor_nome }}` | Nome do professor associado ao curso |
Dados do certificado
| Variável | O que exibe | |---|---| | `{{ data_conclusao }}` | Data em que o aluno atingiu os critérios | | `{{ data_emissao }}` | Data em que o PDF foi gerado (pode diferir da conclusão) | | `{{ codigo_certificado }}` | Código único (ex: CERT-EVB-7K9X2P) | | `{{ qrcode_validacao }}` | Imagem do QR Code com link de validação pública |
Dados da escola
| Variável | O que exibe | |---|---| | `{{ escola_nome }}` | Nome da loja/escola | | `{{ assinatura_professor }}` | Imagem de assinatura do professor (se cadastrada) | | `{{ assinatura_escola }}` | Imagem de assinatura da escola (se cadastrada) |
Como inserir variáveis no template
No editor visual
- Selecione ou crie uma caixa de texto
- Clique em {{ }} na barra de formatação para abrir a lista de variáveis disponíveis, ou digite o nome da variável diretamente na caixa
- A variável aparece como texto no editor e é substituída pelo valor real na geração do PDF
No upload de imagem estática (template PNG/PDF)
Templates estáticos não suportam variáveis dinâmicas — o layout é fixo. Para usar variáveis, use o editor visual ou o template padrão da evob.
Variáveis customizadas
Para exibir informações não cobertas pelas variáveis padrão:
Curso > Certificação > Avançado > Variáveis personalizadasExemplos de uso:
- `{{ nota_final }}` — nota da avaliação final
- `{{ turma_periodo }}` — período letivo
- `{{ cidade_evento }}` — cidade do evento (presencial)
⚠️ Variáveis customizadas exigem que o valor seja preenchido manualmente por turma ou por aluno. Se não preenchidas, aparecem em branco no certificado.
Boas práticas
✅ Faça
- Pré-visualize o certificado com nome de aluno longo (ex: "Anastácia Cavalcante de Menezes") — é o caso mais provável de causar quebra de layout
- Preencha a carga horária nas informações do curso antes de publicar — `{{ carga_horaria }}` sai como "0 horas" se não preenchida
- Use `{{ turma_nome }}` em vez de texto fixo quando o mesmo template serve a turmas diferentes
❌ Não faça
- Escrever o nome do aluno ou do curso como texto fixo no template — o certificado ficará igual para todos os alunos
- Criar variável customizada sem definir quem vai preencher o valor antes da emissão
- Usar `{{ aluno_documento }}` em templates que serão validados publicamente — o CPF do aluno não deve aparecer no link de validação público
Erros comuns
"A variável aparece como texto literal no PDF (ex: `{{ aluno_nome }}`)"
A variável foi digitada fora de uma caixa de texto no editor visual, ou foi adicionada em um template de imagem estática que não suporta variáveis. Verifique se está usando o editor visual e se a variável está dentro de uma caixa de texto.
"O campo `{{ carga_horaria }}` mostra '0 horas'"
A carga horária não foi preenchida em Curso > Informações básicas > Carga horária. Preencha e reemita os certificados já gerados.
"O `{{ professor_nome }}` está em branco"
O professor não foi associado ao curso. Acesse Curso > Informações básicas > Professor e vincule o educador correto.
"A variável customizada aparece em branco no certificado"
O valor da variável não foi preenchido para essa turma ou aluno. Acesse Curso > Certificação > Avançado > Variáveis personalizadas e preencha antes de reemitir.
Próximos passos
- 📖 Editor visual do certificado
- 📖 Como funciona certificado de conclusão
- 📖 Reemissão e revogação de certificados
- 📖 Certificado por turma — templates diferentes
- 📖 Cadastrar professores
Foi útil este artigo? 👍 👎 Falar com CS (em produção) · Pergunte ao Vob 🤖 (em produção) Última atualização: 2026-05-05