Base de Conhecimento

Heartbeat do WordPress: o que é e quando limitar

  • wordpress, heartbeat api, admin-ajax, painel do wordpress, mu-plugins
  • Usuários acharam útil: 0

Salvamento automático, trava de edição e aviso de sessão: o que o Heartbeat faz, como medir os pedidos no navegador e como espaçar o intervalo dentro da faixa que o código aceita.

Por Redação Eleven Host · @robson.direitodigital · 22 de novembro de 2026 · 9 min de leitura

Arte da Eleven Host: janela de terminal com o título: Heartbeat do WordPress: o que é e quando limitar

Capa da Redação Eleven Host para o guia: Heartbeat do WordPress: o que é e quando limitar Arte: Eleven Host

O Heartbeat do WordPress é a rotina que mantém o painel conversando com o servidor enquanto você está logado: guarda rascunhos, avisa quando outra pessoa está editando o mesmo post e mostra a caixa de login quando a sessão expira.

Antes de desligar, prefira espaçar. Pelo código do WordPress, o salvamento automático, a trava de edição e o aviso de sessão dependem do Heartbeat; um intervalo maior, até 120 segundos, espaça os pedidos e mantém esses recursos.

O que é a Heartbeat API

Pelo manual de plugins do WordPress, a Heartbeat API é uma forma simples de consulta periódica ao servidor, embutida no próprio WordPress, que permite atualizar a tela quase em tempo real. Ao carregar a página, o código no navegador agenda um "tick" que se repete de tempos em tempos.

A cada tick, o navegador junta os dados que as telas e os plugins querem enviar e manda tudo ao servidor. Do lado do servidor, o manipulador do admin-ajax recebe, monta e filtra a resposta e devolve em JSON. Quando a resposta chega, o navegador dispara um evento para quem estiver esperando aqueles dados.

No código-fonte, o pedido sai pelo método POST para o endereço do admin-ajax.php, com o campo action valendo heartbeat, a identificação da tela aberta, se a janela tem foco, o intervalo em uso e um código de verificação (nonce). Se o nonce falta, o servidor devolve erro. Do lado do PHP, a função que atende o pedido passa os dados pelos filtros heartbeat_received e heartbeat_send, dispara a ação heartbeat_tick e acrescenta a hora do servidor antes de responder.

O que ele faz no painel

O comentário no topo do arquivo heartbeat.js resume as tarefas: transportar a trava de post, o aviso de login expirado e o salvamento automático, entre outras, enquanto o usuário está logado. O registro dos filtros no núcleo confirma cada uma:

  • Trava de edição: na lista de posts, o WordPress confere quais estão sendo editados; na tela de edição, confere e renova a trava a cada tick. Se outra pessoa assumiu o post, a resposta traz o nome e o avatar dela.
  • Salvamento automático: a função heartbeat_autosave grava o rascunho recebido e responde com a hora em que ele foi salvo.
  • Aviso de sessão: a função wp_auth_check manda o sinal que faz aparecer a caixa de login quando você não está mais logado ou quando o cookie entrou no período de tolerância.

Na lista de scripts do núcleo, os scripts de salvamento automático e de verificação de login são registrados como dependentes do script heartbeat. Por isso desligar o Heartbeat inteiro tem efeito colateral.

Intervalo padrão e quando ele muda

O manual de plugins fala em ticks a cada 15 a 120 segundos. O comentário no topo do heartbeat.js fala em 15 a 60 segundos, mas isso diverge do resto: no código atual do heartbeat.js, o valor inicial é de 60 segundos, e a checagem interna aceita de 1 a 3600 segundos: abaixo de 1 vira 1, acima de 3600 vira 3600.

O próprio código desacelera em várias situações:

  • janela sem foco ou aba escondida: o intervalo passa a 120 segundos, com o comentário de que a trava de post expira depois de 150 segundos;
  • 5 minutos sem mouse nem teclado: o ritmo diminui;
  • 10 minutos sem atividade: o Heartbeat é suspenso, quando a suspensão está ligada;
  • 60 minutos sem atividade: suspende sempre.

Há também o modo rápido: quando uma tela pede, o intervalo cai para 5 segundos durante 30 ticks (2 minutos e 30 segundos), por padrão.

Um detalhe que pesa na conta: a função wp_heartbeat_set_suspension desliga a suspensão nas telas de adicionar e editar post. Assim, o editor aberto não para aos 10 minutos de inatividade; só para pela regra dos 60 minutos.

Uma nota sobre onde o site fica

Todo site WordPress fica guardado em algum servidor, contratado ou próprio.

Quem prefere administrar o próprio servidor encontra VPS na Eleven Host. VPS a partir de R$ 29,90/mês no Plano Bronze; confira na loja o que cada plano inclui. Ver VPS

Para entender o que é uma VPS e como escolher, há o guia simples de servidor VPS para iniciantes.

Como ver as chamadas no navegador

Dá para conferir o Heartbeat sem instalar nada. Pela documentação do Chrome DevTools:

  1. Com o painel do WordPress aberto, pressione Control+Shift+J (Windows e Linux) ou Command+Option+J (Mac). As ferramentas abrem no Console.
  2. Clique na aba Network. O registro só acontece com as ferramentas abertas, então recarregue a página.
  3. Na caixa Filter, digite admin-ajax para mostrar só os pedidos a esse endereço.
  4. Deixe a tela parada por um ou dois minutos e veja os pedidos se repetirem. Entre as colunas padrão estão Status e Time.
  5. Clique num pedido: abrem as abas Headers, Preview, Response, Initiator e Timing.

Recomendamos repetir o teste na tela de edição de um post e numa tela comum do painel, para comparar. Os nomes das abas podem aparecer em português, conforme o idioma do navegador.

Quando o Heartbeat pesa

A conta é simples: cada aba do painel aberta por alguém logado gera um pedido ao admin-ajax.php a cada intervalo, e cada pedido é atendido pelo PHP do site. Os casos em que vale olhar são estes:

  • abas do editor abertas o dia todo, já que ali a suspensão por inatividade de 10 minutos fica desligada;
  • equipe com vários editores, cada um com várias abas do painel;
  • tema ou plugin que carrega o Heartbeat no site público. O código prevê esse uso: fora do painel, a configuração padrão aponta o endereço do admin-ajax.php.

Na documentação consultada, não há um número de pedidos a partir do qual o Heartbeat vira problema. Por isso, meça na aba Network antes e depois de mudar.

Também não confunda com o agendador interno: o WP-Cron é disparado pelas visitas ao site, enquanto o Heartbeat é disparado pelas telas abertas de quem está logado. A troca do WP-Cron pelo cron do servidor está em WP-Cron: como trocar pelo cron do servidor.

Como limitar com o filtro heartbeat_settings

O WordPress passa as configurações do Heartbeat pelo filtro heartbeat_settings, existente desde a versão 3.6.0. Na página de referência do filtro, a nota de exemplo muda a chave interval e comenta que o valor pode ficar entre 15 e 120 segundos. Uma opção que não depende do tema é o plugin obrigatório (mu-plugin).

Pela documentação de mu-plugins, a pasta padrão é wp-content/mu-plugins, só arquivos PHP soltos nessa pasta são carregados (subpastas, não), e eles não aparecem na lista comum de plugins nem podem ser desativados pelo painel. Também não recebem aviso de atualização.

Passo 1. Na pasta wp-content, crie a pasta mu-plugins, se ela ainda não existir.

Passo 2. Dentro dela, crie o arquivo heartbeat-intervalo.php com o conteúdo abaixo. O exemplo é nosso, montado no formato da nota da documentação, com 120 segundos, e não foi testado:

<?php

/*

* Plugin Name: Intervalo do Heartbeat

*/

add_filter( 'heartbeat_settings', function ( $settings ) {

$settings['interval'] = 120;

return $settings;

} );

O recuo de 4 espaços nas duas linhas de dentro da função pode sumir ao copiar daqui; no PHP ele serve só para leitura. O comentário com Plugin Name é o mínimo que o manual de plugins pede no cabeçalho.

Passo 3. Abra o painel e repita o teste da aba Network. Os pedidos ao admin-ajax devem passar a se espaçar, mas confira no seu site: este passo não foi testado por nós.

Passo 4. Para voltar ao padrão, apague o arquivo. Pela documentação, é assim que se desativa um mu-plugin.

Se o site já tem tema filho, o mesmo trecho, sem a linha <?php e sem o comentário do cabeçalho, pode ir no functions.php dele. A documentação de temas explica que o functions.php do filho não substitui o do pai: os dois carregam, o do filho logo antes. Como criar um tema filho está em Tema filho WordPress: o que é e como criar. Recomendamos não colocar o trecho no functions.php do tema principal.

O que se perde ao espaçar ou desligar

Até 120 segundos, o código não aponta perda de recursos; eles seguem, com menos frequência. Acima de 120, o comentário do código sobre o minimalInterval diz que recursos como a trava de post passam a ser limitados ou desligados, e a trava expira depois de 150 segundos sem renovação. Por isso recomendamos não passar de 120.

Desligar o script por completo pesa mais. Como o salvamento automático e o aviso de sessão dependem do Heartbeat, você perde:

  • o salvamento automático feito pelo Heartbeat (como o editor de blocos salva por conta própria não foi verificado aqui);
  • o aviso de que outra pessoa está editando o mesmo post;
  • a caixa de login no meio da edição quando a sessão expira.

Em equipe com mais de um editor, recomendamos manter o Heartbeat ligado no editor e só espaçar o intervalo.

Checklist do Heartbeat

  • abrir a aba Network e filtrar por admin-ajax;
  • contar os pedidos com o painel parado e no editor;
  • criar wp-content/mu-plugins/heartbeat-intervalo.php;
  • definir interval entre 15 e 120;
  • medir de novo na aba Network;
  • testar o salvamento automático e a trava com dois usuários;
  • para desfazer, apagar o arquivo.

Uma ficha com o intervalo escolhido

Recomendamos anotar o valor definido, a data e o arquivo onde o filtro ficou.

Endereços como o do seu painel partem de um domínio, que pode ser registrado na Eleven Host. Buscar domínio

Perguntas frequentes

O Heartbeat do WordPress roda para quem só visita o site?

As tarefas do núcleo, como trava de post e salvamento automático, ficam no painel de quem está logado. No site público, o código prevê o uso fora do painel quando um tema ou plugin carrega o script; a aba Network mostra se isso acontece.

Qual é o intervalo padrão?

No código atual do heartbeat.js, 60 segundos, com 120 segundos quando a janela fica sem foco. O manual de plugins fala em ticks de 15 a 120 segundos.

Posso usar um intervalo de 300 segundos?

O código aceita, mas o comentário sobre o minimalInterval diz que, acima de 120 segundos, recursos como a trava de post ficam limitados ou desligados. A nota do filtro sugere ficar entre 15 e 120.

Onde coloco o filtro se não tenho tema filho?

Num mu-plugin, em wp-content/mu-plugins. Ele carrega antes dos plugins comuns, não depende do tema e se desativa apagando o arquivo.

Esta resposta lhe foi útil?

Artigos Relacionados