Logo da agência no cPanel sem perder tudo no update
Logotipo, favicon e cores aplicados no nível da revenda duram; arquivo de tema editado na mão não dura. Mapa do que sobrevive, checklist para padronizar contas novas e a frase para alinhar expectativa com o cliente.

Resposta curta: a marca da agência no cPanel se aplica no WHM da revenda, em três camadas: logotipo e favicon (configuração, sobrevivem à atualização), cores via cPanel Styles (sobrevivem, mas podem exigir ajuste) e edição direta do tema, que é sempre desfeita pelo update.
Neste artigo
- As três camadas de marca do cPanel e por que elas duram tempos diferentes
- O que sobrevive à atualização do cPanel e o que é sobrescrito
- Por que a marca se aplica no WHM da revenda e não conta por conta
- Checklist de padronização por marca atendida
- A logo não aparece: como descobrir se é cache, nível errado ou arquivo inválido
- O que você não deve prometer ao cliente sobre a personalização
- O que responder quando o cliente pergunta de quem é o painel
- Rotina de cinco minutos para conferir a marca depois de cada atualização
As três camadas de marca do cPanel e por que elas duram tempos diferentes
Quando o cliente abre o painel, ele vê três camadas diferentes, e elas têm durabilidades diferentes. Confundir as três é a origem de quase todo branding que "sumiu depois da atualização".
- Camada de marca: logotipo, favicon, nome público, links de ajuda e documentação, informação de contato do provedor. É configuração, fica guardada como ajuste do servidor/revenda.
- Camada de estilo: cores e CSS aplicados sobre o tema oficial, via cPanel Styles. É um arquivo que você envia, ligado a uma versão do tema.
- Camada de tema: o tema em si (o Jupiter, mantido pela cPanel). É código do fornecedor e é substituído a cada atualização.
A regra prática que resolve 90% das decisões: o que você preenche em formulário tende a sobreviver; o que você sobrescreve em arquivo do tema vai embora. A documentação oficial de temas da cPanel é explícita quanto ao risco de modificar temas padrão, e orienta criar um estilo ou tema próprio em vez de editar o original (Themes, docs.cpanel.net).
O que sobrevive à atualização do cPanel e o que é sobrescrito
| Item | Onde se configura | Sobrevive ao update do cPanel |
|---|---|---|
| Logotipo do cabeçalho | WHM, área de customização de marca | Sim, é configuração |
| Favicon | WHM, mesma área de customização | Sim |
| Nome público / contato da agência | WHM, customização de marca | Sim |
| URL de ajuda e de documentação | WHM, customização de marca | Sim |
| Cores e CSS via cPanel Style próprio | WHM, Styles (estilo enviado por você) | Normalmente sim, mas pode quebrar visualmente se o tema mudar a marcação |
| Edição direta de arquivos do tema Jupiter | /usr/local/cpanel/base/frontend/jupiter/ |
Não. É sobrescrito |
| Troca do tema padrão por tema de terceiros | Pacote / conta | Depende do fornecedor do tema, não da cPanel |
| Texto de rodapé injetado por plugin de terceiro | Plugin | Depende do plugin |
A linha do meio é a que dá dor de cabeça em agência. Um estilo seu continua lá depois do update, o arquivo continua existindo, mas se o tema reorganizou classes CSS o resultado visual pode sair torto. Por isso estilo customizado entra no checklist de verificação pós-atualização, não no "configurei e esqueci".
Por que a marca se aplica no WHM da revenda e não conta por conta
Se você é revendedor, trabalhe sempre de cima para baixo: ajuste no WHM da revenda, não conta por conta. A customização de marca no WHM vale para as contas sob aquela revenda, então um ajuste atende o portfólio inteiro, inclusive contas futuras.
Como preparar logo, favicon e cores antes de abrir o WHM
Tenha a logo em PNG com fundo transparente e o favicon em .ico ou PNG quadrado. Logo muito alta estoura o cabeçalho; prefira uma versão horizontal, enxuta, legível a 30 px de altura. Teste no escuro e no claro, porque o cabeçalho do Jupiter não é branco puro.
Um checklist de nomes padronizados economiza tempo quando você tem várias marcas:
branding/
agencia-x/
logo-cpanel.png # horizontal, fundo transparente
favicon.ico
cores.txt # #hex primário, secundário, link
links.txt # URL de suporte, URL de documentação
Onde preencher logotipo, favicon e links de suporte no WHM
No WHM, abra a área de customização (Customization) e preencha logotipo, favicon, nome público e os links de ajuda/documentação. Salve e abra o cPanel de uma conta de teste em janela anônima. Cache de navegador engana muito nessa hora, e favicon é o campeão de cache teimoso.
Mudar cores com cPanel Style em vez de editar o tema Jupiter
Para cor, use o recurso de Styles do WHM, que permite disponibilizar estilos próprios para as contas. A documentação de temas da cPanel descreve estilo como a maneira suportada de alterar aparência sem tocar no tema original (docs.cpanel.net/whm/themes). Esse é o ponto que separa trabalho que dura de trabalho que você vai refazer.
Se a tentação de abrir o diretório do tema e trocar uma cor no CSS aparecer, lembre do custo real: a próxima atualização restaura o arquivo, o cliente vê a mudança sumir, e você gasta uma hora para descobrir que não foi "bug do servidor".
Deixar o estilo padrão e o cpanel3-skel prontos para contas novas
Duas coisas devem estar prontas antes do próximo cliente entrar:
- O estilo padrão definido no nível da revenda, para a conta nova já nascer com a aparência certa.
- O
cpanel3-skel, que define os arquivos iniciais dopublic_htmlda conta nova. É ali que entra uma página "em construção" com a sua marca, em vez do índice padrão do servidor.
Quem já organizou Feature List e versão padrão de PHP por revenda reconhece o padrão: o trabalho é configurar o molde, não repetir a tarefa em cada conta.
Checklist de padronização por marca atendida
Use isto como procedimento interno, uma passada por marca atendida.
- Arquivos de marca validados (logo horizontal, favicon quadrado, hex das cores).
- Logo e favicon aplicados na customização do WHM da revenda.
- Nome público e contato de suporte apontando para a agência, não para o fornecedor.
- URL de ajuda apontando para a sua base de conhecimento ou para o formulário de chamado.
- Estilo de cores criado e definido como padrão da revenda.
cpanel3-skelcom página inicial da agência e, se fizer sentido, umrobots.txtque bloqueie a indexação do provisório.- Conta de teste criada do zero para conferir se tudo apareceu sem intervenção manual.
- Print do cPanel já personalizado guardado na pasta do cliente, com data. Serve de prova em caso de dúvida futura.
- Registro no seu controle de qual versão do cPanel estava ativa quando o estilo foi criado.
- Revisão agendada: depois de cada atualização maior do painel, abrir uma conta e olhar.
O item 9 parece burocracia e é o que mais ajuda. Quando o visual quebra, a primeira pergunta é "o estilo foi feito para qual versão do tema".
A logo não aparece: como descobrir se é cache, nível errado ou arquivo inválido
Antes de abrir chamado com o provedor, elimine as causas banais, nesta ordem:
- Cache do navegador: abra em janela anônima e force recarga. Favicon pode exigir fechar a aba e reabrir.
- Nível errado: a marca foi aplicada no WHM da revenda ou só na conta de teste? Configuração em conta individual não se propaga para as outras.
- Arquivo inválido: dimensão exagerada, formato não suportado ou arquivo corrompido fazem o painel cair no padrão silenciosamente.
- Conta criada antes da configuração: contas antigas podem continuar com o estilo que tinham. Verifique o estilo selecionado dentro do cPanel da conta.
- Proxy ou CDN na frente do painel: se o acesso ao cPanel passa por algum intermediário com cache, o ativo antigo pode ficar preso.
Para saber se o navegador está recebendo o arquivo novo ou uma cópia velha, pegue a URL do próprio ativo: abra o cPanel logado, clique com o botão direito no logotipo e copie o endereço da imagem (o favicon costuma estar no <link rel="icon"> do HTML). Depois peça só os cabeçalhos dessa URL:
curl -sI 'https://seuservidor.com.br:2083/cpsess0000000000/<caminho-do-ativo>.png'
Três cabeçalhos respondem a pergunta:
Last-Modified: data do arquivo que o servidor está entregando agora. Se for anterior ao momento em que você subiu a logo nova, o upload não chegou onde você pensa.ETag: muda quando o conteúdo muda. Rode ocurlantes e depois de trocar o arquivo; se o valor for idêntico, o servidor está servindo o mesmo ativo.Cache-ControleExpires: dizem por quanto tempo navegador e qualquer cache no caminho vão guardar a versão atual.
Se Last-Modified e ETag já refletem o arquivo novo e mesmo assim a tela continua velha, o problema está no cache do navegador ou em algum intermediário, não na configuração. Isso evita que você desfaça um ajuste correto por achar que não funcionou.
O que você não deve prometer ao cliente sobre a personalização
Três coisas estão fora do seu controle, e vender o contrário cria conflito depois:
- A URL do painel. O endereço pode conter o domínio do servidor ou da hospedagem. Dá para suavizar com um subdomínio seu apontando para o painel, mas isso depende de configuração do provedor e de certificado válido.
- Textos internos e nomes de ferramentas. "cPanel", "Gerenciador de Arquivos", nomes de recursos e mensagens de erro vêm do fornecedor e mudam quando ele quiser.
- Layout após atualização. A cPanel pode alterar estrutura do tema. Seu estilo continua aplicado, o resultado visual pode exigir ajuste. A própria documentação recomenda não depender de modificações no tema padrão (Themes).
Coloque isso no escopo do contrato com uma linha só: "personalização visual do painel (logotipo, favicon, cores e contatos de suporte), sujeita a ajustes após atualizações do fabricante do painel". Protege os dois lados e evita a conversa chata seis meses depois.
O que responder quando o cliente pergunta de quem é o painel
Quando o cliente perguntar de quem é o painel, ou quando notar o nome "cPanel" na tela, uma resposta curta encerra o assunto sem prometer o impossível:
Para e-mail de onboarding, uma variação ainda mais curta funciona melhor:
A segunda frase é a mais importante: você antecipa a mudança e já se posiciona como quem resolve. Cliente que foi avisado não abre reclamação, abre pedido.
Rotina de cinco minutos para conferir a marca depois de cada atualização
Depois de qualquer atualização relevante do painel, faça a mesma passada curta, sempre na mesma ordem, para não depender de memória:
- Abrir o cPanel de uma conta real em janela anônima.
- Conferir logotipo no cabeçalho e favicon na aba.
- Conferir se o link de ajuda ainda aponta para a sua base de conhecimento.
- Conferir se as cores do estilo continuam coerentes (menu, botões, cabeçalho).
- Criar uma conta de teste e descartar, só para validar que o padrão de contas novas continua aplicado.
Se algo quebrou, corrija o estilo, não o tema. Refazer um estilo leva minutos; refazer uma customização de tema leva horas e quebra de novo no próximo ciclo. É a diferença entre uma entrega que se mantém sozinha e uma que vira manutenção recorrente não faturada.
Referências
- Documentação oficial (cpanel) — Themes. Consultado em 2026-10-07.