Base de Conhecimento

Modo de manutenção WordPress: como ativar e sair

  • wordpress, modo de manutenção, wp-cli, http 503, retry-after
  • Usuários acharam útil: 0

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

Arte da Eleven Host: janela de terminal com o título: Modo de manutenção WordPress: como ativar e sair

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:

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 activate e deactivate pelo 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 .maintenance da 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.php personalizado, 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.

Esta resposta lhe foi útil?

Artigos Relacionados