Como usar temas personalizados no Power BI: passo a passo

Todo relatório da empresa com uma cara diferente é um problema de governança, não de gosto#

Se você já abriu cinco relatórios de áreas diferentes da mesma empresa e viu cinco paletas de cor, cinco fontes e cinco tamanhos de título, você já sentiu na pele o problema que os temas personalizados Power BI resolvem. Não é vaidade. É consistência, velocidade de produção e credibilidade do dado. Quando cada analista escolhe a cor do gráfico no olho, o resultado é um portfólio de relatórios que parece ter saído de dez empresas distintas, e o usuário final gasta energia decodificando o visual em vez de ler o número.

Um tema no Power BI é um arquivo JSON que define, de forma centralizada, cores, fontes, tamanhos e o estilo padrão de cada tipo de visual. Você aplica esse arquivo ao relatório e, a partir dali, todo mundo herda o mesmo padrão. Neste guia eu vou direto ao ponto: o que é, quando usar, como criar o arquivo passo a passo, os erros que mais vejo em cliente e as boas práticas que separam um tema decorativo de um tema que realmente escala. É um conteúdo de fundação, então serve tanto para quem está montando o primeiro padrão quanto para quem quer arrumar a bagunça que já existe.

Um tema personalizado é um JSON que controla cor, fonte e estilo de visual de uma vez só#

Na prática, o Power BI trabalha com dois níveis de tema. O nível simples, que a maioria conhece, define apenas a paleta de cores de dados e algumas cores estruturais. O nível avançado, que é onde mora o poder de verdade, define o estilo padrão de cada visual: fonte do título, cor de fundo, borda, formato de rótulo de dados, comportamento de eixo e por aí vai. Os dois vivem no mesmo arquivo JSON.

A estrutura mínima de um tema tem poucos campos. Um nome, uma lista de cores de dados e um punhado de cores estruturais. A partir daí você adiciona a seção visualStyles, que é onde a mágica acontece e também onde mora a maior parte da complexidade.

Campo do JSON	O que controla	Nível
name	Nome do tema (obrigatório)	Simples
dataColors	Paleta usada nas séries dos gráficos	Simples
background	Cor de fundo geral	Simples
foreground	Cor de texto e elementos padrão	Simples
tableAccent	Cor de destaque em tabelas e matrizes	Simples
textClasses	Fontes e tamanhos por classe de texto (título, cabeçalho, rótulo)	Avançado
visualStyles	Estilo padrão de cada tipo de visual	Avançado

O ponto que quase ninguém entende no começo: o tema não trava o relatório. Ele define o padrão. Qualquer formatação que você aplicar manualmente em um visual específico continua ganhando do tema. Isso é bom e ruim ao mesmo tempo, e eu volto nesse ponto na seção de erros.

Vale a pena criar um tema quando o relatório sai do seu computador#

Nem todo relatório precisa de um tema personalizado. Se é uma análise pontual que você vai usar uma vez e jogar fora, não perca tempo. O tema personalizado começa a pagar a conta quando o relatório vira ativo da empresa: circula entre áreas, é publicado no Power BI Service, tem mais de uma pessoa mexendo, ou precisa carregar a identidade visual da marca.

Os cenários onde eu sempre recomendo montar um tema:

• Padrão corporativo. A empresa tem manual de marca e os relatórios precisam respeitar cor primária, secundária e fonte oficial.
• Múltiplos autores. Quando três, quatro, dez analistas produzem relatórios, o tema é o que impede que cada um invente a própria paleta.
• Acessibilidade. Definir cores com contraste adequado e uma paleta segura para daltonismo no tema garante que ninguém esqueça disso no calor da entrega.
• Velocidade. Com um bom tema, o analista para de formatar cada gráfico na unha. O visual já nasce pronto, e ele foca no que importa, que é a modelagem e a análise.

Esse último ponto é subestimado. Já vi equipe economizar horas por relatório só porque parou de ajustar tamanho de fonte de título gráfico por gráfico. Padronização não é só estética, é produtividade. Se a sua operação de BI já está madura o suficiente para pensar nisso, provavelmente também está na hora de olhar governança de dados no Power BI com mais seriedade, porque tema é só a ponta visível desse iceberg.

Passo a passo para criar e aplicar um tema personalizado#

Vou dividir em dois caminhos, porque eles atendem públicos diferentes. Primeiro o caminho pela interface, para quem quer resultado rápido sem escrever JSON. Depois o caminho pelo arquivo, que é o que uso em projeto sério.

Caminho 1: pela interface do Power BI Desktop#

1. Abra o Power BI Desktop e vá na guia Exibição (View).
2. No grupo Temas, clique na seta para expandir a galeria e escolha Personalizar tema atual.
3. Na janela que abre, ajuste as cores de dados, cor de fundo, cores de destaque, o texto (família de fonte e tamanhos) e os elementos visuais como bordas e sombras.
4. Clique em Aplicar. O relatório inteiro atualiza na hora.
5. Ainda no menu Temas, use Salvar tema atual para exportar o resultado como um arquivo JSON. Guarde esse arquivo, porque ele é o seu ponto de partida reutilizável.

Esse caminho cobre cor e fonte com folga, mas a interface não expõe tudo. Estilo detalhado de visual específico, muitas vezes, só dá para fazer editando o JSON na mão.

Caminho 2: pelo arquivo JSON#

1. Comece pelo arquivo exportado no caminho anterior, ou por um esqueleto mínimo.
2. Abra o JSON em um editor de código, como o VS Code, que valida a sintaxe e evita erro de vírgula.
3. Defina o essencial primeiro. Um exemplo mínimo funcional:

{ "name": "Fynx Corporate", "dataColors": ["#1B3A5B", "#2E86AB", "#F18F01", "#C73E1D", "#6A994E"], "background": "#FFFFFF", "foreground": "#1B3A5B", "tableAccent": "#2E86AB" }

4. Adicione a seção visualStyles para padronizar visuais. Por exemplo, definir que todo título de gráfico use uma fonte e tamanho fixos, ou que todo fundo de visual seja transparente.
5. Salve o arquivo com extensão .json.
6. No Power BI Desktop, vá em Exibição, expanda Temas e clique em Procurar temas. Selecione o arquivo.
7. Confira o resultado visual em algumas páginas antes de considerar pronto.

A tabela abaixo resume qual caminho escolher conforme a sua situação.

Situação	Caminho recomendado	Por quê
Precisa de resultado rápido, sem código	Interface	Cobre cor e fonte sem escrever JSON
Padrão corporativo para vários relatórios	Arquivo JSON	Reutilizável, versionável, controlável
Estilo detalhado por tipo de visual	Arquivo JSON	A interface não expõe todos os campos
Só quer testar a paleta da marca	Interface	Ajuste visual e imediato
Tema mantido por um time de BI	Arquivo JSON	Entra em repositório e revisão

Uma vez que o arquivo existe, ele vira um ativo. Você o guarda em um repositório, versiona, e todo relatório novo começa aplicando o mesmo JSON. É aqui que tema deixa de ser gosto pessoal e vira infraestrutura.

Os erros que mais vejo em tema personalizado#

Depois de anos arrumando ambiente de cliente, os problemas se repetem. Listo os mais comuns, porque saber o que evitar economiza mais tempo do que saber o que fazer.

Formatar visual na mão por cima do tema. Esse é o erro número um. O analista aplica o tema, mas continua ajustando cor e fonte manualmente em cada gráfico. Formatação manual sempre ganha do tema. Resultado: você troca o tema depois e metade dos visuais não muda, porque estão travados na formatação individual. A regra é simples: se está no tema, não mexa no visual. Só formate na mão o que for exceção real.

JSON inválido que o Power BI recusa sem explicar direito. Uma vírgula sobrando, uma aspa errada, um colchete não fechado. O Power BI dá uma mensagem genérica de importação. Sempre valide o JSON em um editor antes de importar. Isso resolve 90% das falhas de carga.

Paleta com poucas cores. Você define cinco cores de dados e cria um gráfico com oito séries. O Power BI repete ou interpola as cores, e o visual fica confuso. Pense em quantas séries os seus visuais realmente têm e dimensione a paleta para isso.

Ignorar contraste e acessibilidade. Cor bonita no monitor do designer pode ser ilegível para quem tem baixa visão ou daltonismo, e péssima quando o relatório é impresso ou projetado. Teste contraste de texto sobre fundo e evite depender só de cor para diferenciar informação crítica.

Tratar tema como decoração e esquecer da consistência. Tema não é só cor bonita. Se o título de um gráfico está em um tamanho e o do lado em outro, o tema falhou no seu propósito. O valor está na uniformidade, não no visual isolado.

Erro comum	Consequência	Como evitar
Formatar visual por cima do tema	Tema não propaga mudanças	Só formatar exceções reais
JSON inválido	Power BI recusa a importação	Validar em editor antes de importar
Paleta curta demais	Cores repetidas em gráficos densos	Dimensionar paleta pelo número de séries
Ignorar contraste	Relatório ilegível para parte dos usuários	Testar contraste e daltonismo
Tratar tema como enfeite	Falta de consistência real	Padronizar tamanhos e estilos, não só cor

Boas práticas para o tema durar e escalar#

Um tema bem feito é um que sobrevive a mudança de marca, entrada de novos analistas e crescimento do portfólio. Algumas práticas que valem a pena adotar desde o começo:

Versione o arquivo. Guarde o JSON em um repositório Git ou em uma pasta controlada. Todo mudança de tema deveria passar por revisão, do mesmo jeito que código. Se você já usa integração do Power BI com Git para versionar relatórios, o tema entra junto naturalmente.

Comece do padrão de marca, não do gosto pessoal. Puxe as cores oficiais do manual da empresa. Cor primária, secundária, cores de apoio. Isso evita a discussão sem fim sobre qual azul usar, porque a resposta já está definida pela marca.

Defina uma paleta sequencial e uma categórica. Cores categóricas servem para diferenciar itens sem ordem, como produtos. Cores sequenciais servem para representar intensidade, como um mapa de calor. Confundir as duas é um erro clássico de visualização.

Documente o tema. Um pequeno README ao lado do JSON explicando qual cor é para quê, quando usar cada uma, poupa horas de dúvida do time. Tema sem documentação vira caixa preta.

Padronize o texto com classes. Use textClasses para definir fonte e tamanho de título, cabeçalho e rótulo de uma vez. Isso é o que garante que dois gráficos lado a lado tenham o mesmo peso visual.

Teste em contexto real. Aplique o tema em um relatório de verdade, com dados reais, e olhe em tela cheia, no celular e impresso. Tema que só foi validado em um gráfico isolado costuma revelar problemas quando encontra a densidade da produção.

Se a sua empresa está tratando padronização visual a sério, provavelmente o próximo passo é estruturar tudo o que roda em volta: nomenclatura, workspaces, ciclo de vida de relatório. Esse é o território dos nossos serviços de Power BI e vale olhar também o guia completo de Power BI para empresas no Brasil, que amarra tema com o resto da operação de BI.

Perguntas frequentes#

O tema personalizado afeta relatórios já publicados no Power BI Service?

O tema é aplicado no arquivo do relatório, no Power BI Desktop. Ao republicar o arquivo com o tema aplicado, o relatório no Service passa a refletir o novo padrão. Ele não muda relatórios antigos automaticamente. Cada relatório precisa ser aberto, ter o tema aplicado e ser republicado. Por isso, quanto antes você padronizar, menos retrabalho terá depois.

Preciso saber programar para criar um tema em JSON?

Não. O caminho pela interface do Power BI Desktop cobre cor e fonte sem escrever uma linha de código. Você só precisa mexer no JSON quando quer controlar detalhes que a interface não expõe, como o estilo padrão de um tipo específico de visual. E mesmo aí, editar JSON é copiar, colar e ajustar valores, não é desenvolver software.

Posso usar a fonte da minha empresa no tema?

Sim, desde que a fonte esteja disponível no ambiente onde o relatório é consumido. O Power BI usa fontes instaladas no sistema e um conjunto de fontes web. Se você definir uma fonte corporativa que não está instalada na máquina do usuário, o Power BI cai em uma fonte substituta. Para consumo no Service e no navegador, prefira fontes amplamente suportadas ou confirme a disponibilidade antes.

Qual a diferença entre o tema simples e o tema avançado?

O tema simples controla a paleta de cores de dados e algumas cores estruturais como fundo e destaque. O tema avançado, através da seção visualStyles, controla o estilo padrão de cada tipo de visual: fonte de título, borda, fundo, rótulo de dados e muito mais. Comece pelo simples e evolua para o avançado conforme a necessidade de padronização cresce.

Um tema pode piorar a performance do relatório?

Não. O tema define aparência, não afeta consulta, modelo ou volume de dados. Performance de relatório é uma questão de modelagem, DAX e volume, não de tema. Se o seu relatório está lento, o problema está em outro lugar, e vale olhar boas práticas de modelagem e DAX em vez do visual.

Como faço para reverter e voltar ao tema padrão do Power BI?

Na guia Exibição, no menu de temas, o Power BI oferece os temas internos. Basta selecionar o tema padrão para descartar o personalizado. Vale lembrar que qualquer formatação manual que você aplicou em visuais específicos não é revertida pela troca de tema, porque formatação individual é independente do tema.

Padronizar o visual é o começo, não o fim#

Tema personalizado é uma das coisas de maior retorno e menor esforço no Power BI. Você monta um arquivo JSON uma vez, e todo relatório novo nasce consistente, alinhado à marca e mais rápido de produzir. O segredo não está em escolher a cor perfeita, e sim em disciplinar o time para respeitar o padrão e não formatar por cima dele.

Mas seja honesto sobre onde o tema para. Ele resolve aparência. Não resolve modelagem ruim, DAX lento, workspace bagunçado ou falta de governança. Se a padronização visual está expondo problemas mais profundos na sua operação de BI, é sinal de que chegou a hora de olhar o todo. Se você quer estruturar isso com quem já fez mais de 2.000 soluções Microsoft em seis anos de mercado, fale com a gente e a gente ajuda a transformar relatório bonito em operação de dados que funciona.