# 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.

> 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.

João Rizzon · 2026-10-08 · Revenda

---

## 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](https://docs.cpanel.net/whm/themes/)).

## 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](https://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 do `public_html` da 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-skel` com página inicial da agência e, se fizer sentido, um `robots.txt` que 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:

```bash
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 o `curl` antes e depois de trocar o arquivo; se o valor for idêntico, o servidor está servindo o mesmo ativo.
- `Cache-Control` e `Expires`: 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](https://docs.cpanel.net/whm/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:

> **** "O painel de hospedagem é operado pela nossa agência e personalizado com a sua marca: logotipo, cores e canais de suporte apontam para a gente. A tecnologia por trás é o cPanel, um software de mercado, então alguns nomes de telas e o endereço de acesso vêm dele e podem mudar quando o fabricante atualiza o sistema. Qualquer dúvida, você fala com a gente, não com terceiros."

Para e-mail de onboarding, uma variação ainda mais curta funciona melhor:

> **** "Acesso ao painel com a nossa identidade. Suporte é com a agência. Atualizações do software podem alterar detalhes visuais; se isso acontecer, nós ajustamos."

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.

