Modo de manutenção WordPress: como ativar e sair
Entenda o arquivo .maintenance das atualizações, ative e desative o modo pelo WP-CLI, responda 503 com Retry-After e veja o que conferir com o site preso em Briefly unavailable.
Por Redação Eleven Host · @robson.direitodigital · 19 de novembro de 2026 · 9 min de leitura

Capa da Redação Eleven Host para o guia: Modo de manutenção WordPress: como ativar e sair Arte: Eleven Host
Modo de manutenção WordPress é o estado em que o site deixa de mostrar as páginas e exibe um aviso de pausa aos visitantes. O próprio WordPress usa esse modo nas atualizações, e você pode ativar à mão antes de mexer no site.
Pela referência da função wp_maintenance(), o aviso padrão do WordPress responde com o código HTTP 503 e o cabeçalho Retry-After: 600. Se o site ficar preso no aviso depois de uma atualização que falhou, a documentação de atualização indica conferir o arquivo .maintenance na pasta raiz e removê-lo depois de confirmar que a atualização não está mais rodando.
O que é o modo de manutenção
Quando o modo está ativo, quem abre o site não vê as páginas de costume, e sim uma tela curta avisando que ele está em manutenção. No aviso padrão, a mensagem original, em inglês, é:
Briefly unavailable for scheduled maintenance. Check back in a minute.
Pela referência da função wp_maintenance() no site de desenvolvedores do WordPress, ela existe desde a versão 3.0.0 e é de uso interno do núcleo. Sem personalização, ela envia o cabeçalho Retry-After: 600 e responde com o código 503, que indica serviço indisponível.
O modo de manutenção é um aviso de pausa e não substitui outras etapas de cuidado com o site, como cópias e atualizações.
Quando usar
O modo faz sentido em mudanças que deixam o site incompleto por alguns minutos, quando o visitante veria uma página quebrada ou pela metade. Alguns exemplos:
- atualização do núcleo, de temas ou de plugins feita à mão;
- troca de tema ou mudança grande no layout;
- migração de arquivos ou do banco de dados para outro servidor;
- troca da versão do PHP, assunto de Atualizar versão do PHP: como trocar sem quebrar o site.
Para ajustes pequenos, como corrigir um texto ou trocar uma imagem, recomendamos avaliar se a pausa é mesmo necessária, já que o site fica fora do ar para os visitantes durante o período.
Um dos produtos vendidos pela Eleven Host é a VPS, o servidor virtual privado. VPS a partir de R$ 29,90/mês no Plano Bronze; confira na loja o que cada plano inclui. Ver VPS
O modo automático nas atualizações
Segundo a documentação de atualização do WordPress, ao clicar em atualizar no painel, o WordPress coloca o site em modo de manutenção por um tempo curto. Visitantes podem ver o aviso nesse período, o que a documentação trata como normal. Quando a atualização termina, o próprio WordPress tira o site do modo.
A documentação de atualização cita um arquivo chamado .maintenance, na pasta raiz do WordPress. Pela referência da função wp_is_maintenance_mode(), presente desde a versão 5.5.0, o WordPress procura esse arquivo, que guarda na variável $upgrading a hora em que foi criado.
Ainda pela mesma referência, o site fica em manutenção se o arquivo foi criado há menos de 10 minutos. Com 10 minutos ou mais desde a hora gravada em $upgrading, a função deixa de considerar o modo ativo.
Como o nome começa com ponto, o .maintenance pode ficar oculto no programa de FTP ou SFTP. Recomendamos ligar a exibição de arquivos ocultos antes de procurar por ele.
Como ativar o modo de manutenção à mão
Antes de ativar, recomendamos anotar o que vai mudar e fazer uma cópia do site. A documentação de atualização do WordPress diz que fazer backup antes é uma boa ideia.
1. Pelo WP-CLI
O WP-CLI é a ferramenta de linha de comando do WordPress. Entre os subcomandos da documentação dele, estes tratam do modo de manutenção:
wp maintenance-mode activate: ativa o modo;wp maintenance-mode deactivate: desativa o modo;wp maintenance-mode status: mostra se o modo está ativo;wp maintenance-mode is-active: informa o estado pelo código de saída, para uso em scripts.
Um exemplo de comando, dentro da pasta do WordPress e com o usuário dono dos arquivos:
wp maintenance-mode activate
wp maintenance-mode status
Esse caminho pede acesso ao terminal do servidor com o WP-CLI instalado, como numa VPS. O básico desse tipo de servidor está em O que é servidor VPS: guia simples para iniciantes. Confira os comandos no seu próprio servidor antes de usar numa mudança de verdade.
2. Personalizar o aviso com maintenance.php
A documentação de atualização explica que dá para trocar a mensagem padrão criando um arquivo maintenance.php na pasta wp-content. O WordPress carrega esse arquivo quando o modo de manutenção está ativo, e o recurso pede acesso aos arquivos do site e algum conhecimento de PHP e HTML.
Pela referência de wp_maintenance(), quando esse arquivo existe, ele entra no lugar do aviso padrão. Por isso recomendamos que o próprio arquivo envie o código 503 e o cabeçalho Retry-After. Um exemplo, não testado, para conferir no seu servidor:
<?php
http_response_code( 503 );
header( 'Retry-After: 3600' );
echo 'Site em manutenção. Volte em breve.';
O valor 3600 representa uma hora em segundos. Troque pelo tempo que você espera ficar em manutenção. Lembre que o arquivo continua na pasta e volta a ser usado nas próximas atualizações.
3. Plugins de modo de manutenção
O diretório oficial de plugins do WordPress tem plugins de modo de manutenção. Se você preferir esse caminho, recomendamos conferir na descrição do plugin se ele responde com o código 503, e não com 200, e se envia o cabeçalho Retry-After.
503 e Retry-After: o aviso certo para os buscadores
Vale cuidar do código HTTP que o site devolve durante a pausa. Pela documentação da MDN, o 503 indica que o servidor não está pronto para atender, e manutenção é uma das causas comuns. A MDN acrescenta que essa resposta deve ser usada para situações temporárias e que o Retry-After deve trazer, se possível, o tempo estimado de volta.
O cabeçalho aceita dois formatos, segundo a MDN: uma data ou um número de segundos. Os exemplos da página:
Retry-After: Wed, 21 Oct 2015 07:28:00 GMT
Retry-After: 120
A página do Retry-After na MDN diz que o suporte ao cabeçalho ainda é irregular, mas que alguns rastreadores, como o Googlebot, o respeitam. Por isso a MDN considera útil mandá-lo junto com o 503, para os buscadores continuarem indexando o site quando a parada acabar.
Na documentação do Google Search Central sobre erros HTTP, um 503 faz o Google reduzir o ritmo de rastreamento do site, em proporção ao número de URLs com erro. Quando o servidor volta a responder com códigos 2xx, o rastreamento aumenta aos poucos. A página também diz que URLs já indexadas ficam no índice, mas acabam removidas se o erro persistir.
Nas orientações do Google para pausar um site, a página informativa com 503 aparece para uma desativação urgente de 1 a 2 dias, com o Retry-After trazendo uma data ou duração aproximada. Para períodos maiores, o Google orienta deixar uma página inicial indexável no lugar. A mesma página pede para não devolver 503 no robots.txt, porque isso bloqueia todo o rastreamento.
A MDN lembra ainda que o 503 é temporário e, em geral, não deve ficar em cache. Se o site usa cache de páginas, recomendamos limpar o cache ao sair do modo, para ninguém continuar vendo o aviso. Ajustes do próprio WordPress, que não envolvem o modo de manutenção, ficam em wp-config.php: o que é e como editar com segurança.
Site preso em "Briefly unavailable": como resolver
Às vezes uma atualização para no meio e o aviso de manutenção continua na tela. A documentação de atualização do WordPress orienta, nesse caso, conferir se o arquivo .maintenance ainda está na pasta raiz do WordPress.
Segundo a mesma documentação, o arquivo pode ser removido por FTP ou pelo gerenciador de arquivos da hospedagem, depois de confirmar que a atualização não está mais rodando. Em seguida, confira o site e, se preciso, tente a atualização de novo. Um exemplo de comando para quem usa o terminal, dentro da pasta raiz do WordPress:
ls -a
rm .maintenance
O primeiro comando lista também os arquivos ocultos; o segundo apaga o arquivo. Recomendamos conferir o nome com atenção antes de apagar. Na atualização manual depois de uma falha da automática, a documentação também orienta apagar o .maintenance da pasta do WordPress.
Resumo rápido
- Automático: o WordPress coloca o site em manutenção durante a atualização e tira o modo ao terminar; o
.maintenanceé o arquivo da pasta raiz que a referência verifica. - À mão:
wp maintenance-mode activateedeactivatepelo WP-CLI. - Aviso próprio:
wp-content/maintenance.php, enviando 503 e Retry-After. - Preso no aviso: confirmar que a atualização parou e remover o
.maintenanceda raiz.
Checklist antes de sair do modo
Antes de desativar o modo, recomendamos passar por esta lista:
- a página inicial e as páginas mais visitadas abrem sem erro;
- o painel do WordPress abre e o login funciona;
- plugins desativados para a mudança foram reativados, como a documentação de atualização lembra;
- formulários, carrinho e busca interna respondem;
- o cache de páginas foi limpo, como pede a documentação de atualização quando há cache;
- o site voltou a responder com código 200, e não 503;
- o
maintenance.phppersonalizado, se existir, tem um texto que ainda serve para as próximas atualizações.
Um caderno das pausas do site
Recomendamos anotar a data, o motivo e o tempo de cada pausa, para planejar melhor a próxima.
Fazer o registro de um domínio, com centenas de extensões disponíveis, é uma das opções da Eleven Host. Buscar domínio
Perguntas frequentes
O que é o modo de manutenção do WordPress?
É o estado em que o site mostra um aviso de pausa no lugar das páginas. O WordPress usa esse modo nas atualizações, e você pode ativar à mão, por exemplo com o WP-CLI.
Por que o site ficou preso em "Briefly unavailable for scheduled maintenance"?
Uma causa possível é uma atualização que falhou e deixou o arquivo .maintenance na pasta raiz. A documentação do WordPress orienta remover esse arquivo depois de confirmar que a atualização não está mais rodando.
O modo de manutenção prejudica o site no Google?
Pela documentação do Google, um 503 reduz o ritmo de rastreamento, e URLs já indexadas acabam removidas se o erro persistir. Na orientação para pausar um site por 1 a 2 dias, o Google indica uma página informativa com 503 e o cabeçalho Retry-After.