Variáveis do certificado

Como usar

No editor de Builder > Certificados, as variáveis ficam na coluna esquerda, em Variáveis disponíveis.

• Na aba Visual: clique no texto, depois em Inserir campo e escolha a variável. Ela aparece no texto com o rótulo, por exemplo "Nome do aluno".
• Na aba Código: escreva o código com dois asteriscos de cada lado, por exemplo **student_name**. Clicar em uma variável na coluna esquerda copia o código dela.

Use o código exatamente como está nas tabelas. Um código escrito errado não é substituído e sai no certificado como texto.

Aluno e curso

Carga horária é a soma da duração das aulas da turma, no formato HH:MM:SS. Sai vazia quando nenhuma aula tem duração cadastrada.

Título do módulo faz sentido em modelos do tipo Disciplina.

Endereço da turma

Disponível quando a turma presencial tem endereço cadastrado.

Dados do aluno (membro)

Preenchidos na emissão, com o que o aluno informou no cadastro.

Trabalho do aluno

Exemplo

Texto do modelo padrão para um curso:

Certificamos que
**student_name**
concluiu o curso **course_title**.
Realizado por **store_name** no dia **date**.

Resultado para uma aluna:

Certificamos que
Maria Silva
concluiu o curso Coloração Avançada.
Realizado por Academia Exemplo no dia 02/10/2026.

Quando o dado não existe

A variável é trocada pelo dado que existe no momento da emissão. O que acontece quando ele falta depende do grupo:

• Carga horária: sai em branco quando nenhuma aula da turma tem duração.
• Endereço da turma: se a turma não tem endereço cadastrado (uma turma online, por exemplo), as variáveis desse grupo não são substituídas. O código aparece escrito no certificado, como **city**.
• Dados do aluno e trabalho do aluno: dependem do que o aluno preencheu no cadastro. Se o dado está em branco, o resultado não é garantido.

⚠️ Por isso, use as variáveis de endereço só em modelos de produtos presenciais, com o endereço da turma preenchido. E use as variáveis de dados do aluno só quando o cadastro exige aquele campo. Os campos do cadastro são definidos em Builder > Autenticação > Cadastro.

Antes de liberar um modelo com essas variáveis, emita um certificado de teste.

Cuidados

• CPF e documento: só inclua no certificado quando houver exigência real. É dado pessoal e fica exposto em um arquivo que o aluno compartilha.
• Carga horária: o formato é HH:MM:SS, por exemplo 40:00:00. Se você quer "40 horas" por extenso, escreva o número direto no texto do modelo.
• Data: a variável traz a data de emissão. Para outra data, escreva no texto.

O que não existe

• Variáveis de nota, percentual de aproveitamento ou frequência.
• Nome do professor como variável.
• Código de validação ou QR code como variável.
• Condições (mostrar um trecho só se o campo existir).
• Criação de variáveis próprias.

Veja também

• Criar um modelo de certificado
• Modelos de certificado
• Modelo padrão e ordem de escolha
• Como funciona o certificado