Publicado em 11 de outubro de 2026

Principais pontos:

  • Variáveis no Figma funcionam como ‘design tokens’, permitindo que você altere um único valor (ex: cor primária) e atualize automaticamente todo o arquivo ou sistema conectado.
  • Existem quatro tipos principais de coleções de variáveis: Cores, Tipografia, Números (espaçamentos) e Strings, cada uma ideal para diferentes partes do design system.
  • Para manter a consistência, sempre nomeie suas variáveis de forma semântica (ex: `color/primary` em vez de `blue_500`) e use modos para gerenciar temas claros e escuros.
  • Integrar variáveis ao seu Design System reduz drasticamente o tempo de manutenção e erros de implementação.

Aprender a criar variáveis no Figma é o passo mais importante para transformar desenhos estáticos em sistemas escaláveis. Se você ainda copia e cola códigos hexadecimais ou ajusta margens manualmente tela por tela, está perdendo horas preciosas e aumentando o risco de inconsistências visuais.

Variáveis não são apenas um recurso técnico; elas são a base de qualquer Design System moderno. Elas permitem que você defina valores uma única vez (como a cor da marca ou o tamanho padrão do texto) e os aplique em centenas de componentes. Quando a empresa decide mudar o tom azul do logotipo, você altera a variável raiz, e todo o produto se atualiza instantaneamente.

O Que São Variáveis no Figma e Por Que Usá-las?

No Figma, uma variável é um par chave-valor que pode ser atribuído a propriedades de camadas específicas, como preenchimento (fill), borda (stroke), efeitos e layout (espaçamento). Diferente dos estilos antigos, as variáveis suportam lógica condicional e múltiplos modos, o que significa que elas podem mudar de comportamento dependendo do contexto (por exemplo, claro vs. escuro).

Imagine que você tem um botão que precisa ser azul no modo claro e laranja no modo escuro. Com variáveis, você cria uma coleção chamada `button/background`, define o valor no modo light e outro no dark. Ao trocar o tema na tela, o botão muda sozinho. Sem variáveis, você teria que duplicar o componente ou fazer ajustes manuais perigosos.

Os 4 Tipos de Coleções de Variáveis

Antes de começar, é crucial entender quais dados você quer parametrizar. O Figma oferece quatro tipos nativos:

  • Cores: Preenchimentos, bordas e efeitos de sombra. Ideais para paletas de marca e estados de interface (hover, foco).
  • Números: Espaçamento interno/externo, raio de borda, largura/altura. Ótimos para grids e ritmos verticais.
  • Strings: Textos, URLs de imagens ou nomes de fontes. Úteis para internacionalização ou troca rápida de assets.
  • Bool (Experimental): Valores verdadeiro/falso. Usados raramente para mostrar/esconder elementos complexos via protótipos avançados.

Passo a Passo: Como Criar Suas Primeiras Variáveis no Figma

Vamos construir um exemplo prático de uma paleta de cores básica e aplicá-la a um componente. Siga esta ordem para evitar confusão.

1. Acesse o Painel de Variáveis

Na barra lateral esquerda do Figma, clique na aba Assets (Ativos). Lá dentro, procure o ícone de Variables (geralmente representado por um ícone de ‘x’ ou lista). Clique em New collection para iniciar.

Dê um nome descritivo à sua coleção, como `Colors/Core`. Evite nomes genéricos como `Collection 1`. Isso ajuda outros designers a entenderem o propósito visualmente.

Interface do Figma mostrando o painel de criação de variáveis de design

2. Defina o Tipo de Dados

Assim que criar a coleção, o Figma pedirá para você escolher o tipo de dados. Para nosso exemplo, selecione Color.

Adicione suas primeiras chaves. A nomenclatura é vital. Use uma estrutura hierárquica com barras (`/`). Exemplo:

  • `brand/primary`
  • `brand/secondary`
  • `neutral/white`
  • `neutral/black`

Isso organiza as variáveis em grupos visuais quando você for usá-las nos menus de seleção.

3. Vincule os Valores às Chaves

Agora, atribua os códigos hexadecimais reais aos valores. Para `brand/primary`, coloque o azul oficial da sua marca (ex: #0066FF). Repita para as outras chaves.

Dica de especialista: Não use apenas a cor final. Se você trabalha com tons de cinza complexos, crie variáveis intermediárias. Muitas vezes, `neutral/grey-100` depende de `neutral/grey-50` ajustado. Você pode criar referências cruzadas entre variáveis usando sintaxe específica, mas para iniciantes, mantenha os valores literais por enquanto.

4. Crie Modos (Light/Dark)

Na mesma janela de edição da coleção, você verá a seção Modes. Por padrão, existe o modo `Default`. Clique em Add mode e crie um chamado `Dark`.

Para cada variável, você agora tem dois campos de input. Mantenha o mesmo código hexadecimal para `neutral/white` (que continua branco), mas mude o `brand/primary` para um tom mais brilhante (ex: #3399FF) que funcione bem sobre fundo escuro. Isso permite que o designer troque o tema da tela inteira com um clique no canto superior direito do painel de propriedades.

Aplicando Variáveis em Componentes Reais

Ter as variáveis criadas não adianta se você não souber usá-las nos desenhos. Vamos aplicar nossa paleta em um botão simples.

Selecionando a Camada Correta

Selecione o retângulo que representa o fundo do seu botão. No painel direito, vá até a seção Fill. Em vez de ver o código hexadecimal, você verá um ícone de ‘x’ (variáveis) ao lado do quadrado de cor.

Clique nesse ícone. Uma lista suspensa aparecerá mostrando todas as suas coleções de cores. Selecione `Colors/Core` e depois a variável `brand/primary`. Pronto! O botão agora está “preso” a essa variável.

Botão de UI sendo editado no Figma com aplicação de variáveis de cor

Testando a Escalabilidade

Aqui está a prova real de eficiência. Selecione qualquer camada onde você usou `brand/primary`. Vá ao painel de Variáveis, edite o valor de `brand/primary` no modo Light para uma cor totalmente diferente (ex: vermelho). Observe que todos os botões que usam essa variável mudam de cor simultaneamente.

Isso elimina a necessidade de fazer buscas globais (Ctrl+H) ou substituir estilos manualmente. É preciso, rápido e livre de erros humanos.

Erros Comuns ao Criar Variáveis no Figma

Muitos designers cometem o mesmo erro no início: tentam parametrizar tudo. Nem tudo deve ser uma variável.

1. Overengineering (Excesso de Complexidade)

Se você tem um elemento decorativo único que nunca será reutilizado, não crie uma variável para ele. Variáveis adicionam peso ao arquivo e curva de aprendizado. Use-as apenas para padrões recorrentes.

2. Nomes Ambíguos

Evite nomes como `blue` ou `size-large`. O que é grande? Grande para um título ou para um body text? Prefira `text/title/lg` ou `space/padding/md`. A semântica deve descrever a função, não a aparência física.

3. Esquecer de Atualizar Componentes Principais

Se você criou instâncias de botões antigas antes das variáveis, elas não se atualizam sozinhas. Certifique-se de editar o Component Master (componente principal) para aplicar as novas variáveis. As instâncias filhas herdarão a mudança automaticamente.

Conectando Variáveis ao Seu Workflow

Para quem trabalha com desenvolvedores, as variáveis do Figma não são só bonitas — elas são exportáveis. Ferramentas como Tokens Studio ou plugins nativos permitem converter essas variáveis em JSON, CSS Variables ou SCSS maps.

Isso significa que a decisão de design tomada no Figma chega intacta no código. Se o dev precisa ajustar o espaçamento do card, ele consulta a variável `space/card/internal`, que reflete exatamente o que foi aprovado pelo time de UX.

Opinião pessoal: Na minha visão, dominar variáveis separa o amador do profissional sênior. Não é difícil tecnicamente, mas exige disciplina de nomenclatura. Eu recomendo começar criando apenas uma coleção de cores básicas e, após duas semanas de uso confortável, adicionar espaçamento. Tentar fazer tudo de uma vez gera frustração e abandono do recurso.

Perguntas Frequentes

Posso usar variáveis em arquivos gratuitos do Figma?

Sim. A funcionalidade de Variáveis está disponível para todos os usuários, inclusive nos planos gratuitos Starter. O limite está no número de coleções e participantes no time, mas para uso individual ou pequenos times, funciona perfeitamente.

Qual a diferença entre Estilos de Cor e Variáveis?

Estilos de Cor são locais e limitados (só guardam o valor fixo). Variáveis são dinâmicas, podem ter múltiplos modos (temas), aceitam lógica matemática básica e são compartilháveis entre bibliotecas de forma mais robusta. Variáveis são o sucessor natural dos Estilos.

Como compartilhar minhas variáveis com outros projetos?

Publique seu arquivo como uma Biblioteca (Publish Library). Assim que publicar, as coleções de variáveis tornam-se disponíveis para outros arquivos que usam essa biblioteca. Os consumidores poderão selecionar suas variáveis nas opções de preenchimento e layout.

Variáveis funcionam em protótipos?

Atualmente, a interação direta de trocar valores de variáveis via ações de protótipo é limitada. Você pode trocar o modo ativo (ex: passar de Light para Dark) em um frame específico, o que afeta o visual, mas não consegue alterar o valor numérico de uma variável dinâmicaamente durante a navegação sem plugins externos ou codificação avançada.

Próximos Passos

Agora que você sabe como criar variáveis no Figma, o desafio é a consistência. Pegue um projeto antigo seu, identifique as 5 cores e os 3 tamanhos de espaçamento mais usados, e transforme-os em variáveis. Refaça os componentes principais usando essas novas chaves.

Este processo leva cerca de uma hora no primeiro dia, mas economiza dezenas de horas nos meses seguintes. Para aprofundar seu conhecimento em arquitetura de design, leia nosso guia completo sobre Ferramentas de Criação de Conteúdo e veja como integrar o Figma ao restante do seu stack criativo.

Perguntas frequentes

Posso usar variáveis em arquivos gratuitos do Figma?

Sim, a funcionalidade está disponível para todos, incluindo o plano Starter. Limitações existem apenas quanto ao número de coleções e colaboradores no time.

Qual a diferença entre Estilos de Cor e Variáveis?

Estilos são estáticos e locais. Variáveis são dinâmicas, suportam temas (modos) e lógica de referência, sendo mais poderosas para Design Systems.

Como compartilho minhas variáveis com outros projetos?

Você precisa publicar o arquivo como uma Biblioteca (Library). Uma vez publicado, outras equipes podem acessar suas coleções de variáveis.

Componente de botão no Figma utilizando variáveis de design
Foto: Egor Komarov / Pexels
Ambiente de trabalho focado em criação de design tokens no computador
Foto: Yan Krukau / Pexels

A

Alberto Rogatto

Editor de Tecnologia

Acompanha o mercado de tecnologia, eletronicos e gadgets ha anos, sempre com foco em ajudar o leitor brasileiro a escolher com o melhor custo-beneficio.

Ver todos os posts de Alberto Rogatto