# O que é o .htaccess e como editar sem derrubar o site

O arquivo oculto que manda no seu site antes de qualquer página carregar, e o caminho de volta: apagar um arquivo e renomear outro.

> sim, você pode editar o .htaccess sozinho. Ele é um arquivo de instruções oculto dentro de public_html que o servidor lê antes de abrir a página. No Gerenciador de Arquivos do cPanel: ligue "Show Hidden Files", baixe uma cópia do arquivo com Download e só então edite.

João Rizzon · 2026-11-02 · Painéis

---

## O que é o .htaccess e por que ele fica oculto

Imagine que o seu site mora em uma sala dentro de um prédio. O prédio é o **servidor**: um computador ligado 24 horas por dia que entrega as páginas para quem digita o endereço do seu site. A sala é a pasta onde ficam os arquivos do seu site.

O `.htaccess` é um bilhete colado na porta dessa sala. Antes de entregar qualquer página para o visitante, o servidor lê o bilhete e obedece ao que está escrito nele. Por isso ele consegue fazer coisas que a página sozinha não faria:

- mandar quem digitou um endereço antigo para o endereço novo (redirecionamento);
- pedir usuário e senha antes de abrir uma pasta;
- mostrar uma página de erro feita por você no lugar da tela cinza padrão;
- bloquear o acesso a determinados arquivos.

O nome começa com ponto por um motivo prático: em servidores Linux, arquivo cujo nome começa com ponto é um **arquivo oculto**. Ele existe, mas não aparece na listagem normal. É por isso que muita gente abre a pasta do site, não vê o `.htaccess` e conclui que ele não existe.

Duas coisas que convém saber antes de continuar. Primeiro: o `.htaccess` vale para a pasta onde está e para as pastas abaixo dela. Segundo: ele é um arquivo de texto puro, sem formatação, e um erro de digitação em uma única linha pode tirar o site inteiro do ar com um erro 500, a mensagem que o servidor mostra quando não consegue entregar a página. Não é motivo para medo, é motivo para fazer cópia antes.

## Pode editar, desde que a cópia exista antes

Pode editar. É um arquivo seu, dentro da sua hospedagem, e o Gerenciador de Arquivos do cPanel existe exatamente para isso.

A condição é uma só: **tenha a cópia de segurança pronta antes de alterar a primeira letra**. Não é uma recomendação de cautela genérica. É a diferença entre um susto de dois minutos e um site fora do ar por horas enquanto você procura alguém para ajudar.

O que este guia entrega é o caminho de ida e o caminho de volta. A regra que você vai colar lá dentro depende do que você quer fazer, e cada tutorial de redirecionamento ou de página de erro traz a sua. O que ninguém costuma ensinar é como desfazer.

## O que ter em mãos antes de abrir o arquivo

- Acesso ao **cPanel**, que é o painel de controle da sua hospedagem. Normalmente você entra por um endereço informado pela empresa que hospeda o site, com usuário e senha próprios (não são os mesmos do WordPress).
- Saber o nome do seu site, para identificar a pasta certa caso você tenha mais de um domínio na mesma conta.
- Dez minutos sem pressa. Não faça isso cinco minutos antes de uma campanha no ar.

Se você não sabe onde fica o seu cPanel, procure no e-mail de boas-vindas da hospedagem. O endereço costuma ser o seu domínio seguido de `/cpanel`.

## O caminho completo no Gerenciador de Arquivos do cPanel

Todo o caminho abaixo é feito com o mouse, dentro do navegador. Não existe terminal nem comando para decorar.

### Abrir o Gerenciador de Arquivos no cPanel

Entre no cPanel e procure a seção **Files** (Arquivos). Clique em **File Manager** (Gerenciador de Arquivos). Abre uma tela dividida: à esquerda a árvore de pastas, à direita a lista de arquivos da pasta selecionada.

**Resultado esperado:** você vê uma lista de pastas com nomes como `etc`, `logs`, `mail`, `public_html`.

### Exibir arquivos ocultos para o .htaccess aparecer

No canto superior direito, clique em **Settings** (Configurações). Marque a opção **Show Hidden Files (dotfiles)** e confirme em **Save**. A [documentação oficial do cPanel](https://docs.cpanel.net/cpanel/files/file-manager/) descreve essa opção como a que exibe os arquivos cujo nome começa com ponto.

**Resultado esperado:** a listagem recarrega e passam a aparecer itens que antes estavam escondidos, entre eles o `.htaccess`.

### Entrar na public_html e achar a pasta certa do site

Clique duas vezes em **public_html**. Essa é a pasta pública: tudo o que está aqui é o que o visitante consegue ver. Se você tem mais de um domínio na mesma conta, o site adicional costuma ficar em uma subpasta dentro de `public_html`, com o nome do domínio.

**Resultado esperado:** você vê os arquivos do site e, agora, o `.htaccess` na lista.

Se o `.htaccess` não aparecer mesmo com os ocultos ligados, é porque ele ainda não existe nessa pasta. É normal em sites recém-criados. Veja o que fazer na seção de erros comuns.

### Baixar a cópia de segurança antes de alterar uma letra

Jeito mais simples e à prova de erro: clique uma vez sobre o `.htaccess` para selecionar e clique em **Download** na barra superior. O arquivo é salvo no seu computador. Guarde em uma pasta que você ache depois.

Se quiser também uma cópia dentro do servidor, são duas etapas, porque a janela de **Copy** pede o caminho da pasta de destino e não um nome de arquivo novo:

- Selecione o `.htaccess` e clique em **Copy**. Abre uma janela pequena, com uma frase dizendo para onde o arquivo será copiado, um campo de texto já preenchido com o caminho atual (algo como `/public_html`) e o botão de confirmação **Copy File(s)**.
- No campo, troque o caminho pelo da pasta que fica um nível acima de `public_html`, que é a pasta inicial da conta, a primeira da árvore à esquerda. Confirme. A cópia vai para lá com o mesmo nome.
- Clique nessa pasta na árvore à esquerda, selecione o `.htaccess` que acabou de chegar e clique em **Rename** (Renomear). Troque o nome para `.htaccess-backup` e confirme.

**Resultado esperado:** o `.htaccess` original continua em `public_html`, intocado, e existe um `.htaccess-backup` guardado na pasta de cima. Esse é o seu caminho de volta.

### Editar e salvar o arquivo

Selecione o `.htaccess` e clique em **Edit** na barra superior. O cPanel pode exibir um aviso sobre codificação de caracteres; siga adiante. Abre um editor de texto simples.

Cole ou altere o que você precisa, sempre em uma linha nova, e clique em **Save Changes** no canto superior direito.

**Resultado esperado:** mensagem de sucesso. A alteração passa a valer na hora, sem reiniciar nada.

### Testar o site em aba anônima logo depois de salvar

Abra o site em uma aba anônima do navegador. Teste a página inicial e uma página interna. Se tudo carrega, pronto.

## Como voltar atrás quando o site cai com erro 500

Tela branca, erro 500 ou "Internal Server Error" logo depois de salvar significa quase sempre que o conteúdo do `.htaccess` tem algo que o servidor não entende. A correção, no caso mais comum, é apagar um arquivo e renomear outro.

| Situação | O que fazer no Gerenciador de Arquivos |
|---|---||
| Você baixou a cópia para o computador | Apague o `.htaccess` do servidor com **Delete** e envie o arquivo salvo com **Upload**, dentro de `public_html` |
| Você guardou a cópia `.htaccess-backup` na pasta acima de `public_html` | Apague o `.htaccess` de `public_html` com **Delete**, selecione o `.htaccess-backup`, use **Copy** para o caminho `/public_html` e lá renomeie a cópia para `.htaccess` com **Rename** |
| Você não fez cópia e só acrescentou linhas | Abra o `.htaccess` em **Edit**, apague as linhas que você colou e salve |
| O arquivo não existia antes e você criou | Apague o `.htaccess` com **Delete** |

Depois de restaurar, recarregue o site em uma aba anônima. O navegador guarda páginas antigas, e isso engana muita gente na hora do teste.

## Erros comuns no .htaccess e o que cada um significa

**O .htaccess não aparece mesmo com os ocultos ligados.** O arquivo não existe nessa pasta. Você pode criar um com **+ File** na barra superior, digitando o nome exato `.htaccess`, com o ponto na frente e sem extensão. Só crie se o tutorial que você está seguindo pedir.

**Existe mais de um .htaccess.** É possível e é normal: um em `public_html` e outro dentro de uma subpasta, por exemplo. O da subpasta vale para aquela subpasta. Mexa no que está na pasta indicada pelo tutorial.

**O editor avisa sobre codificação de caracteres.** É só um aviso sobre acentuação. Pode prosseguir.

**Salvei e nada mudou.** Teste em aba anônima. Se o site usa um serviço de cache (uma cópia pronta da página, guardada para ser entregue mais rápido) ou uma CDN (rede de entrega de conteúdo, um serviço que guarda cópias do seu site em vários lugares do mundo para entregar mais rápido), a página antiga pode continuar sendo entregue por alguns minutos.

**Aparece erro de permissão ao salvar.** O arquivo pode estar marcado como somente leitura. Clique com o botão direito sobre ele, escolha **Change Permissions** e verifique se o dono tem permissão de escrita. Se não tiver certeza do que está fazendo aqui, pare e peça ajuda ao suporte da sua hospedagem: permissão errada em arquivo público é risco de segurança.

## Três situações em que é melhor não mexer

Três situações em que a melhor decisão é fechar o Gerenciador de Arquivos.

- **Você não sabe o que a linha faz.** Copiar uma regra de um fórum sem entender é a origem mais comum de site fora do ar. Procure a fonte oficial da regra antes.
- **Seu site é WordPress e o plugin oferece fazer o mesmo.** Plugins de redirecionamento e de cache escrevem no `.htaccess` de forma controlada. Se existe o botão, use o botão.
- **É o único arquivo entre você e um site que está faturando agora.** Agende para um horário de baixo movimento, com a cópia feita e a aba do Gerenciador de Arquivos já aberta no caminho de volta.

O `.htaccess` deixa de ser assustador no momento em que você sabe desfazer. A regra você acha em qualquer tutorial. A cópia feita antes de editar é o que separa um ajuste de dois minutos de um fim de semana perdido.

