Variáveis no Figma são valores salvos (uma cor, um número, um texto ou um verdadeiro/falso) que você aplica nas propriedades do design e altera em um lugar só. Para criar uma, tire a seleção de tudo com Esc, procure Variáveis locais na barra lateral direita, clique em Abrir variáveis e depois em + Criar variável.
O que torna o recurso útil para uma equipe de produto ou de marca são os modos: a mesma variável guarda um valor para o tema claro e outro para o escuro, e o quadro inteiro troca de tema com um clique. Abaixo está o passo a passo completo, com os quatro tipos, os modos, os aliases (a base dos tokens de design) e os erros que mais travam quem está começando.
O que são variáveis no Figma
Segundo a central de ajuda do Figma, variáveis são valores brutos, como cores, números e strings, que podem mudar conforme o contexto do design. Elas ficam organizadas em coleções, podem ser separadas em grupos dentro de cada coleção e podem ser publicadas na biblioteca da equipe, igual a estilos e componentes.
Qualquer pessoa, em qualquer plano, pode criar e usar variáveis. O que muda com o plano é o resto:
| Recurso | Quem tem acesso |
|---|---|
| Criar e aplicar variáveis | Todos os planos, com acesso de edição ao arquivo |
| Mais de um modo por coleção | Planos Educação, Profissional, Organização e Enterprise |
| Publicar variáveis na biblioteca da equipe | Plano Educação e planos pagos |
| Usar variáveis em protótipos | Plano Educação e planos pagos |
Cada coleção aceita até 5.000 variáveis, então o limite não costuma ser problema nem em design systems grandes.
Os 4 tipos de variáveis e onde cada um entra
Ao clicar em + Criar variável, o Figma pede o tipo. A escolha define em quais propriedades ela pode ser aplicada:
| Tipo | Exemplo de valor | Onde aplicar |
|---|---|---|
| Cor | #FFCD29 | Preenchimento, traço, paradas de gradiente, sombras, estilos de cor |
| Número | 16 ou 12,75 | Raio de canto, largura e altura, preenchimento e espaçamento, tamanho de fonte, altura da linha, opacidade, grades de layout |
| String | “Inter” ou “Olá, mundo!” | Conteúdo do texto, família e estilo da fonte, variantes em protótipos |
| Booleano | true ou false | Visibilidade da camada, variantes com valores true e false |
Três detalhes da documentação evitam dor de cabeça. Variáveis numéricas aceitam decimais até a centésima casa. Na opacidade, qualquer número acima de 100 vira 100. E o espaçamento entre letras é lido em pixels, não em porcentagem.
Como criar variáveis no Figma, passo a passo
- Pressione Esc ou clique em uma área vazia da tela para não ter nada selecionado.
- Na barra lateral direita, encontre Variáveis locais e clique em Abrir variáveis.
- Clique em + Criar variável e escolha o tipo (cor, número, string ou booleano).
- Dê um nome na primeira coluna e um valor na segunda.
- Para organizar, selecione várias variáveis (Command no Mac ou Control no Windows para escolher uma a uma, Shift para um intervalo), clique com o botão direito e escolha Novo grupo com seleção.
Atalhos que ajudam no dia a dia: Shift + Enter duplica as variáveis selecionadas, e o botão direito sobre uma variável mostra Deletar variável. Também dá para copiar variáveis de uma coleção e colar em outra, inclusive em outro arquivo.
Para criar uma nova coleção, use Mais opções > Criar coleção na barra lateral do modal. Se o arquivo ainda não tem nenhuma variável, crie uma primeiro, porque o Figma só libera novas coleções depois disso.
Um cuidado: excluir uma coleção apaga todas as variáveis dela, e as camadas perdem o vínculo. A documentação avisa que a única volta é desfazer na hora ou restaurar uma versão anterior do arquivo.
Como aplicar uma variável no design
Criar a variável não muda nada na tela. Ela só passa a valer depois de aplicada a uma propriedade. O caminho muda conforme o tipo, de acordo com a documentação de aplicação de variáveis:
- Cor: selecione a camada e, na seção Preenchimento ou Traço, clique no ícone de aplicar estilos e variáveis. No seletor, variáveis de cor aparecem como quadrados e estilos de cor como círculos.
- Número: clique no campo da propriedade (raio, espaçamento, tamanho da fonte) e digite =. O seletor da biblioteca abre na hora. Em vários campos também funciona segurar Shift e clicar.
- String: selecione uma camada de texto e, na seção Texto, clique em aplicar variável.
- Booleano: na seção Aparência, clique com o botão direito no ícone do olho (visível/oculto) e escolha a variável.
Para soltar uma variável numérica, clique no campo e apague com Delete ou Backspace. Nas de cor, string e booleano, passe o mouse sobre a variável e clique no ícone de desvincular.
Se o seletor não mostrar nada, o arquivo não tem variável compatível com aquela propriedade. Crie uma do tipo certo ou ative a biblioteca que contém a variável.
Modos de variáveis: tema claro e escuro sem duplicar telas
Um modo é uma coluna de valores dentro da coleção. Cada variável guarda um valor por modo, e a camada mostra o valor do modo em que está. É isso que permite ter um único conjunto de telas para claro e escuro, celular e desktop, ou português e inglês.
Para criar um modo:
- Abra o modal de variáveis e entre na coleção.
- Clique em Novo modo da variável, à direita dos cabeçalhos das colunas. O Figma copia os valores da primeira coluna para a nova.
- Troque os valores que mudam no novo contexto (por exemplo, o fundo de branco para quase preto).
Para trocar o modo de um quadro, selecione-o e, na seção Aparência da barra lateral direita, clique em Aplicar modo da variável e escolha a coleção e o modo. Funciona em camadas, quadros, grupos, seções, componentes e até na página inteira.
Vale entender a lógica do modo padrão. A coluna mais à esquerda é o padrão da coleção. Objetos novos ficam em modo automático, ou seja, herdam o modo do contêiner pai. Se nenhum pai tem modo definido, eles usam o padrão. Por isso, quando uma tela “não troca de tema”, quase sempre o quadro pai ficou sem modo aplicado.
Alias e tokens de design: a estrutura que escala
Uma variável pode apontar para outra do mesmo tipo. O Figma chama isso de alias, e é assim que se monta uma estrutura de tokens de design. Para criar, clique com o botão direito no valor de uma variável, escolha Criar alias e selecione a variável de origem.
Na prática, a maioria dos design systems usa duas camadas. Este é um modelo que você pode copiar:
| Coleção | Variável | Claro | Escuro |
|---|---|---|---|
| Primitivas | azul/500 | #1F6FEB | (um modo só) |
| Primitivas | cinza/50 | #F6F8FA | (um modo só) |
| Primitivas | cinza/900 | #0D1117 | (um modo só) |
| Semânticas | fundo/padrao | alias de cinza/50 | alias de cinza/900 |
| Semânticas | texto/padrao | alias de cinza/900 | alias de cinza/50 |
| Semânticas | acao/primaria | alias de azul/500 | alias de azul/500 |
As telas usam só as semânticas. Se a marca mudar o azul, você altera azul/500 uma vez e tudo que aponta para ele acompanha. Se precisar de um tema de alto contraste, cria um terceiro modo na coleção Semânticas sem tocar nas telas.
Duas configurações completam a estrutura. No escopo (botão direito > Editar variável > aba de escopo), você limita onde a variável aparece, por exemplo uma variável numérica só para raio de canto. Na sintaxe de código, você dá um nome por plataforma (Web, Android e iOS), que aparece nos trechos de código do Dev Mode em CSS, SwiftUI e Compose. Isso facilita bastante a passagem do design para o desenvolvimento.
Para receber dicas curtas de Figma, Photoshop e Illustrator no feed, siga o Instagram da Iglu.
Variáveis ou estilos: qual usar
As duas coisas servem de fonte da verdade e podem ser publicadas na biblioteca, mas resolvem problemas diferentes. A comparação oficial do Figma resume assim:
| Variáveis | Estilos | |
|---|---|---|
| O que guardam | Um valor bruto por modo | Uma combinação de valores (fonte, tamanho e peso juntos; gradientes; imagens) |
| Modos | Sim | Não, a menos que usem variáveis por dentro |
| Alias | Podem apontar para outras variáveis | Não aceitam alias |
| Escopo | Sim | Não |
A posição do próprio Figma é que as variáveis não substituem os estilos. O caminho mais comum é usar os dois: variáveis para os valores (cores, tamanhos, espaçamentos) e estilos de texto e de efeito que usam essas variáveis por dentro. Assim, um estilo de texto com tamanho de fonte 16 no celular e 18 no desktop muda sozinho quando o modo muda.
Variáveis em protótipos
Nos planos pagos e no Educação, variáveis também guardam estado em protótipos. A ação Definir variável muda o valor de uma variável quando um gatilho acontece, como um clique. Com isso dá para atualizar um texto, mostrar ou esconder uma camada ou mudar um tamanho sem criar uma tela nova para cada estado.
Combinado com componentes no Figma e variantes no Figma, o recurso substitui dezenas de quadros duplicados. Um exemplo simples da documentação: uma variável de string chamada shapeName, aplicada a um texto, que muda para “circle” ou “square” conforme a forma clicada. Se você ainda está montando o fluxo, o guia de protótipo no Figma cobre conexões, gatilhos e compartilhamento.
Erros comuns com variáveis (e como evitar)
- A tela não troca de modo: o quadro pai está em automático e nenhum ancestral tem modo definido. Aplique o modo no quadro de nível mais alto.
- A variável numérica sumiu do espaçamento: arrastar as alças de preenchimento ou espaçamento do auto layout no figma direto na tela desvincula a variável. Ajuste pelo campo na barra lateral.
- Booleano não liga na propriedade booleana do componente: hoje isso não é suportado. Crie uma propriedade de variante com os valores true e false e aplique a variável nela.
- Não aparece a opção de novo modo: o plano gratuito não permite mais de um modo por coleção.
- Ícone de informação ao lado do modo: é conflito de versão da variável entre arquivos. Publique a variável no arquivo de origem e aceite as atualizações da biblioteca nos arquivos que a usam, na ordem da cadeia.
- Fonte não muda com a variável de string: o nome precisa bater com a família da fonte. O Figma tolera hífen, sublinhado, maiúsculas e espaços, mas não erro de digitação.
Perguntas frequentes
Variáveis do Figma são gratuitas?
Sim. Qualquer plano, inclusive o gratuito, permite criar e aplicar variáveis. O que exige plano Educação ou pago é ter mais de um modo por coleção, publicar variáveis na biblioteca da equipe e usar variáveis em protótipos.
Como criar variável no Figma?
Tire a seleção de tudo, clique em Abrir variáveis na seção Variáveis locais da barra lateral direita e use + Criar variável. Escolha o tipo, dê um nome e um valor. Para que ela tenha efeito, aplique-a a uma propriedade de uma camada.
Como importar variáveis de outro arquivo no Figma?
O caminho mais simples é publicar a coleção na biblioteca da equipe e ativar essa biblioteca no outro arquivo. Também é possível selecionar variáveis no modal, copiar e colar em uma coleção de outro arquivo. Ao colar objetos com variáveis não publicadas, o Figma oferece copiar essas variáveis para uma nova coleção.
Qual a diferença entre variável e estilo no Figma?
A variável guarda um valor bruto por modo e pode apontar para outra variável. O estilo guarda uma combinação de valores aplicados juntos, como família, tamanho e peso de uma fonte. Na maioria dos projetos, os dois trabalham juntos.
Quantas variáveis cabem em uma coleção?
Até 5.000 variáveis por coleção, segundo a documentação do Figma. O número de modos por coleção depende do plano.
Próximo passo
Comece pequeno: crie uma coleção de primitivas com as cores da marca, uma coleção semântica com alias para elas e dois modos, claro e escuro. Aplique em uma tela só e teste a troca de modo antes de levar para o resto do arquivo.
Siga a Iglu no Instagram e no LinkedIn para mais guias de ferramentas de design, e acompanhe o André Lug, fundador da Iglu, no Instagram.