WP-Cron: como trocar pelo cron do servidor
Veja como o WP-Cron depende das visitas, confira a fila com o WP-CLI, crie a tarefa no crontab e só então desligue o disparo por visita no wp-config.php.
Por Redação Eleven Host · @robson.direitodigital · 20 de novembro de 2026 · 9 min de leitura

Capa da Redação Eleven Host para o guia: WP-Cron: como trocar pelo cron do servidor Arte: Eleven Host
O WP-Cron é o agendador interno do WordPress: publica posts agendados, verifica atualizações e roda tarefas de plugins. Ele só confere a lista quando alguém abre uma página do site, e é por isso que, em site com pouca visita, uma tarefa pode atrasar.
A troca tem uma ordem: primeiro a tarefa do agendador do sistema chamando o wp-cron.php, depois a linha define( 'DISABLE_WP_CRON', true ); no wp-config.php. Na ordem inversa, o site fica um tempo sem nenhum disparo de tarefas.
O que é o WP-Cron
Pelo manual de plugins do WordPress, o WP-Cron é a forma como o WordPress agenda tarefas por tempo, como verificar se há atualizações e publicar posts agendados. O nome vem do cron, o agendador clássico dos sistemas UNIX.
O funcionamento é simples: a cada carregamento de página, o WordPress confere a lista de tarefas agendadas e roda as que já venceram. Plugins também podem agendar tarefas próprias nessa mesma lista.
O manual explica por que o WordPress usa esse modelo: muitas hospedagens compartilhadas não dão acesso ao agendador do sistema, e uma tarefa perdida fica na fila e roda no próximo carregamento de página, sem hora exata, mas acaba rodando.
Por que as tarefas atrasam
A diferença para o cron do sistema está no gatilho. O manual deixa claro que o WP-Cron não fica rodando o tempo todo, como o cron do sistema; ele depende das visitas. O exemplo dado no próprio manual: uma tarefa marcada para as 14h pode só rodar às 17h se ninguém abrir uma página do site nesse intervalo.
Num site pequeno, numa loja com pouco movimento de madrugada ou num ambiente de teste, a espera pode ser longa.
Alguns sinais que podem levar donos de site a olhar o WP-Cron:
- post agendado que passa da hora marcada sem ser publicado;
- e-mail de pedido ou aviso de plugin que só sai quando alguém entra no site;
- site com poucas visitas por dia, em que esses atrasos se repetem.
Esses sinais não provam que a causa é o WP-Cron, mas pedem uma olhada na fila de eventos. Para tirar a dependência das visitas, o manual do WordPress descreve ligar o WP-Cron ao agendador de tarefas do sistema, o que depende de acesso ao agendador do servidor. Sobre servidores VPS em geral, há o guia O que é servidor VPS: guia simples para iniciantes.
Vendida pela Eleven Host, a VPS é um 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
Como ver os eventos agendados com o WP-CLI
Pela documentação do WP-CLI, o grupo wp cron event agenda, roda e apaga eventos, e o wp cron test testa o disparo do WP-Cron e informa o status.
Para listar a fila, a documentação mostra o wp cron event list. Por padrão, ele exibe o nome do gancho (hook), a próxima execução em horário GMT (next_run_gmt), quanto falta para ela (next_run_relative) e a repetição (recurrence). Um exemplo de comando, dentro da pasta do site:
wp cron event list
Recomendamos guardar essa lista antes da troca, para comparar depois.
Passo a passo para trocar pelo cron do servidor
Os comandos abaixo são exemplos para um servidor Linux com acesso ao terminal. Troque o domínio de exemplo example.com e o caminho de exemplo pelos do seu site, e confira cada comando no seu próprio servidor antes de usar.
1. Teste o disparo atual
Pela documentação, o wp cron test confere se a constante DISABLE_WP_CRON está ligada e dá erro se estiver, avisa se ALTERNATE_WP_CRON estiver definida e tenta disparar o WP-Cron por HTTP, avisando se a resposta não for o código 200. Um exemplo de comando:
wp cron test
Por causa da primeira checagem, recomendamos rodar esse teste agora, antes de desligar o disparo por visita. Depois da troca, o erro sobre DISABLE_WP_CRON é esperado e não indica falha.
2. Crie a tarefa no agendador do sistema
Em Linux e macOS, o manual do WordPress indica o cron, editado com crontab -e. Pelo manual do crontab, esse comando abre a tabela de tarefas do usuário atual no editor configurado, e cada usuário pode ter a sua. Recomendamos criar a linha na tabela do mesmo usuário dono dos arquivos do site.
Cada linha tem cinco campos de tempo e o comando. Pelo manual do crontab(5), os campos são minuto (0 a 59), hora (0 a 23), dia do mês (1 a 31), mês (1 a 12) e dia da semana (0 a 7, em que 0 e 7 são domingo). O asterisco vale do primeiro ao último valor, e uma barra seguida de número indica pulos desse tamanho.
Há duas formas de montar a linha. A primeira, que o manual do WordPress mostra, chama o wp-cron.php pelo endereço do site com o wget, que vem instalado em muitos servidores; a opção --delete-after evita gravar a resposta no disco. Usando o intervalo de 15 minutos que o manual traz como exemplo, um exemplo de linha:
*/15 * * * * wget --delete-after https://example.com/wp-cron.php
O manual dá também um exemplo diário, à meia-noite, com 0 0 * * *. O intervalo depende das tarefas do seu site.
A segunda forma usa o WP-CLI no lugar da chamada pelo endereço. Pela documentação, o wp cron event run --due-now roda todos os eventos vencidos naquele momento e respeita a trava doing_cron, que evita execuções sobrepostas. Os parâmetros globais --path (caminho dos arquivos do WordPress) e --quiet (sem mensagens informativas) servem, o primeiro, para apontar o site quando o comando roda fora da pasta dele e, o segundo, para suprimir as mensagens. Um exemplo de linha:
*/15 * * * * wp cron event run --due-now --path=/caminho/do/site --quiet
Recomendamos escolher só uma das duas formas. Se o cron não encontrar o comando wp, use o caminho completo do programa. Os exemplos acima não usam o sinal de porcentagem; pelo manual do crontab(5), ele no comando vira quebra de linha se não tiver barra invertida antes.
3. Confira se a tarefa entrou
Pelo manual do crontab, o crontab -l mostra a tabela atual. Um exemplo de comando:
crontab -l
Recomendamos esperar pelo menos um intervalo e rodar de novo o wp cron event list, para ver se a fila segue andando. Nesta etapa, o disparo por visita ainda está ligado, então o site não fica sem cron enquanto você confere.
4. Desligue o disparo por visita
Com a tarefa do sistema no lugar, o manual do WordPress indica desligar o disparo embutido, para evitar carga extra no servidor. A linha que vai no wp-config.php é esta:
define( 'DISABLE_WP_CRON', true );
Recomendamos pôr a linha junto das outras constantes, antes da linha que carrega o wp-settings.php, e guardar uma cópia do arquivo antes. O artigo wp-config.php: o que é e como editar com segurança mostra como abrir e salvar esse arquivo. Daí em diante, as tarefas passam a depender só da chamada do agendador do sistema.
5. Confira depois da troca
Recomendamos acompanhar o wp cron event list nos dias seguintes, comparando com a lista guardada antes, e agendar um post de teste para depois do próximo intervalo do crontab, lembrando que a tarefa roda no intervalo configurado. Se a fila parar, recomendamos olhar primeiro a linha do crontab.
Outras constantes de cron no wp-config.php
A página de configuração do wp-config.php traz mais duas constantes ligadas ao cron. A WP_CRON_LOCK_TIMEOUT faz com que um processo de cron não rode mais de uma vez a cada tantos segundos; o exemplo da página usa 60:
define( 'WP_CRON_LOCK_TIMEOUT', 60 );
A ALTERNATE_WP_CRON liga um cron alternativo, e a própria página alerta que esse modo tem riscos, porque depende de um serviço que não é nativo do WordPress.
Se for fazer a troca junto com outras mudanças no site, como atualização de tema e plugins, o artigo Modo de manutenção WordPress: como ativar e sair explica como ativar e sair do modo de manutenção do site.
Checklist da troca do WP-Cron
- lista de eventos guardada com
wp cron event list; wp cron testrodado antes de mexer nowp-config.php;- uma só linha no crontab, com
wgetou com WP-CLI, conferida comcrontab -l; - pelo menos um intervalo observado antes de desligar o disparo por visita;
- cópia do
wp-config.phpguardada eDISABLE_WP_CRONemtrue; - fila acompanhada nos dias seguintes e post de teste agendado e publicado depois do intervalo.
Como desfazer
Para voltar ao modelo anterior, recomendamos a ordem inversa: primeiro apague a linha DISABLE_WP_CRON do wp-config.php, para o disparo por visita voltar; depois abra o crontab -e e apague só a linha do WordPress, mantendo as outras tarefas da tabela. Assim, o site não fica sem quem dispare as tarefas durante a volta.
Uma agenda das tarefas do site
Recomendamos anotar quais plugins criam tarefas agendadas e o horário esperado de cada uma, para ter com o que comparar quando algo atrasar.
Para mais um site ou projeto, há registro de domínio na Eleven Host, em centenas de extensões. Buscar domínio
Perguntas frequentes
O WP-Cron é um cron de verdade?
Não no mesmo sentido do cron do sistema. Pelo manual do WordPress, ele não fica rodando o tempo todo: confere as tarefas a cada carregamento de página e roda as que já venceram.
Só a linha DISABLE_WP_CRON no wp-config.php resolve?
Não. Sem uma tarefa do agendador do sistema chamando o wp-cron.php, nada dispara os eventos e eles ficam parados. Crie a tarefa do sistema antes e só depois desligue o disparo por visita.
De quanto em quanto tempo o cron do sistema deve chamar o WP-Cron?
Depende das tarefas do site. O manual do WordPress usa 15 minutos como exemplo e mostra também uma chamada diária à meia-noite. O cron do sistema tira a dependência das visitas, mas a tarefa roda no intervalo configurado, e não no minuto exato marcado no WordPress.
Por que o wp cron test dá erro depois da troca?
Pela documentação do WP-CLI, o comando dá erro quando a constante DISABLE_WP_CRON está ligada, porque o WP-Cron por visita está desligado. Para conferir a fila depois da troca, use o wp cron event list.