Como corrigir o erro de llms.txt no SEOPress
O que é erro de llms.txt no SEOPress?
O llms.txt no SEOPress e um arquivo virtual servido na raiz do site, em https://seusite.com/llms.txt, que oferece um ponto de entrada legivel por maquina para modelos de linguagem como ChatGPT, Claude e Gemini, no mesmo espirito do robots.txt e do sitemap.xml. Ele não e um arquivo fisico no servidor: o SEOPress o gera por reescrita de URL (URL rewriting), igual ao robots.txt padrão do WordPress, e o conteúdo e definido em uma área de texto no painel, com placeholders dinâmicos como nome do site, posts recentes e URL de busca.
O erro aparece de duas maneiras. Na primeira, o endereco /llms.txt retorna 404 porque as regras de reescrita do WordPress ainda não incluem a rota do arquivo, situacao tipica logo após ativar o recurso. Na segunda, o arquivo carrega mas vem vazio porque o toggle global esta desligado ou a área de texto esta sem conteúdo. O recurso e exclusivo do SEOPress PRO e foi introduzido na versão 9.5, entao versões Free ou anteriores não oferecem a aba.
Como identificar
- Ao abrir https://seusite.com/llms.txt o navegador exibe a página de erro do WordPress com a mensagem ‘Page not found’ ou um ‘404 Not Found’ do servidor.
- O arquivo llms.txt carrega, mas a tela aparece totalmente em branco, sem nome do site nem lista de posts.
- A aba llms.txt não existe em SEO -> PRO, indicando SEOPress Free ou versão anterior a 9.5.
- O botão ‘View your llms.txt file’ abre uma URL que cai em 404 mesmo após salvar o conteúdo na área de texto.
- Ferramentas de IA ou validadores externos relatam que o site não expoe um llms.txt acessivel na raiz.
Como prevenir
- Depois de ativar qualquer recurso do SEOPress que gere arquivo virtual, como llms.txt ou sitemap, salve os Links Permanentes uma vez para registrar a rota de imediato.
- Mantenha o SEOPress PRO sempre na versão estavel mais recente, validando antes em staging, para acompanhar mudancas no recurso de llms.txt.
- Padronize o conteúdo do llms.txt com placeholders dinâmicos em vez de texto fixo, para que posts recentes e nome do site se atualizem sozinhos.
- Em ambientes multisite, documente que o llms.txt e administrado em Network Admin -> SEO para evitar configuração no subsite errado.
Causa
- O toggle global da aba SEO -> PRO -> llms.txt esta desligado, entao o SEOPress não registra a rota e o arquivo não e servido.
- As regras de reescrita (permalinks) do WordPress não foram atualizadas depois de ativar o recurso, e como o llms.txt e virtual via URL rewriting, a rota /llms.txt cai em 404 até o flush das rewrite rules.
- A área de texto do llms.txt esta vazia, sem os placeholders como nome do site ou {{latest_posts:X,cpt_key}}, fazendo o arquivo carregar em branco.
- O site usa SEOPress Free ou uma versão anterior a 9.5, que não inclui o recurso de llms.txt e por isso não gera o arquivo.
- Em uma instalação multisite, o llms.txt foi configurado no painel do subsite em vez de Network Admin -> SEO -> llms.txt, onde o recurso e administrado para a rede.
Como resolver
- Confirme o SEOPress PRO na versão 9.5 ou superior: O llms.txt e um recurso exclusivo do SEOPress PRO introduzido na versão 9.5. Em Plugins, verifique se o SEOPress PRO esta ativo e atualizado. Sem ele, a aba do llms.txt nem aparece no menu.
Painel WP -> Plugins -> Plugins Instalados Confirme 'SEOPress PRO' ativo e na versão 9.5 ou superior Painel WP -> Painel -> Atualizações -> atualize o SEOPress se houver versão nova - Ative o recurso na aba llms.txt: Abra a aba do recurso e ligue o toggle global. Enquanto ele estiver desligado, o SEOPress não registra a rota e o arquivo não e servido na raiz do site.
Painel WP -> SEO -> PRO -> aba 'llms.txt' Ative o toggle global do recurso (deixe ligado) Clique em Salvar - Preencha o conteúdo na área de texto: Se o arquivo carrega em branco, e porque a área de texto esta vazia. Use os botões de placeholder abaixo do campo para inserir nome do site, posts recentes e URL de busca, garantindo que o llms.txt tenha conteúdo útil para os modelos de IA.
Na mesma aba llms.txt, clique nos botões de placeholder (Site name, latest posts, search URL) Para listar posts de um tipo: {{latest_posts:10,post}} Clique em Salvar - Atualize os links permanentes para resolver o 404: Como o llms.txt e virtual e depende das regras de reescrita, um 404 na rota /llms.txt se resolve atualizando os permalinks. Basta abrir a tela de Links Permanentes e salvar sem mudar nada, o que forca o WordPress a regravar as rewrite rules e registrar a rota.
Painel WP -> Configurações -> Links Permanentes Clique em 'Salvar alterações' sem alterar nenhuma opção - Valide o arquivo no navegador: Abra o endereco do arquivo direto ou use o botão do próprio SEOPress. Se o conteúdo aparecer, o recurso esta servindo corretamente. Em multisite, configure pelo painel da rede em vez do subsite.
Acesse https://seusite.com/llms.txt no navegador Ou clique no botão 'View your llms.txt file' na aba do recurso Em multisite: Network Admin -> SEO -> llms.txt
<?php
// WP-CLI: forca o flush das rewrite rules para registrar a rota virtual /llms.txt.
// Rode pelo terminal na raiz do WordPress (substitui o 'Salvar' em Links Permanentes).
// wp rewrite flush --hard
// Alternativa por codigo (use em um mu-plugin temporario, nao no functions.php em loop):
add_action( 'init', function () {
if ( get_option( 'full_llms_txt_flushed' ) ) {
return;
}
flush_rewrite_rules( false );
update_option( 'full_llms_txt_flushed', 1 );
}, 99 );














