# Como corrigir o llms.txt que não gera no Rank Math PRO no WordPress

O Rank Math llms.txt não gera quando o módulo LLMS Txt esta desligado, quando o arquivo ainda não foi configurado em Editar llms.txt ou quando as regras de reescrita do WordPress não foram atualizadas, deixando a URL /llms.txt retornar 404 ou um arquivo vazio.

## O que é llms.txt que não gera no Rank Math?

O Rank Math llms.txt e um arquivo em formato Markdown servido na raiz do site, em /llms.txt, que aponta os modelos de IA como ChatGPT, Gemini e Claude para o conteúdo mais importante do site. Diferente do robots.txt, que orienta buscadores tradicionais, o llms.txt e um arquivo leve que ajuda assistentes de IA a entender o site na hora de responder perguntas. No Rank Math ele e um arquivo virtual: não existe no disco, e gerado dinamicamente pelo plugin a partir das regras de reescrita do WordPress.

O recurso vem do módulo LLMS Txt, que precisa ser ativado no painel do Rank Math, e o conteúdo e definido na tela Editar llms.txt. Segundo a documentação oficial do Rank Math, o arquivo nasce vazio até ser configurado e exclui automaticamente posts marcados como noindex. Quando o módulo esta desligado, o arquivo não foi salvo ou as regras de reescrita estão desatualizadas, a URL /llms.txt não gera o conteúdo esperado e o site responde com 404 ou página em branco.

## Como identificar

- Abrir https://seusite.com/llms.txt retorna a página 'Página não encontrada' ou um erro 404 do WordPress em vez do conteúdo em Markdown.
- O arquivo /llms.txt carrega, mas vem totalmente vazio ou so com o cabeçalho, sem listar os posts e páginas do site.
- A opção 'Edit llms.txt' não aparece em Rank Math SEO -> General Settings, indicando que o módulo não esta ativo.
- O módulo 'LLMS Txt' não consta no Rank Math SEO -> Dashboard, em geral por estar usando uma versão antiga do plugin.
- Após salvar as configurações em Editar llms.txt, o preview no painel mostra o conteúdo, mas a URL pública /llms.txt continua em 404 para visitantes.

**Antes de começar:** Antes de regravar permalinks ou alterar configurações de cache em producao, faca um backup do site (arquivos e banco de dados) ou teste primeiro em um ambiente de staging, para reverter rápido caso alguma URL pare de resolver.

## Como prevenir

- Mantenha o Rank Math sempre na versão estavel mais recente, já que o módulo LLMS Txt so existe nas versões novas e recebe ajustes a cada release.
- Após ativar qualquer módulo do Rank Math que cria URLs virtuais, salve os Links Permanentes para regravar as regras de reescrita e evitar 404.
- Padronize a estrutura de permalinks como amigavel em todos os sites, nunca deixando em 'Padrão', para que rotas virtuais como /llms.txt e /sitemap_index.xml resolvam.
- Inclua /llms.txt nas exclusoes de cache do plugin de cache e da CDN, para que o arquivo seja sempre regenerado quando o conteúdo do site mudar.

Erros relacionados

- [Como corrigir schema markup quebrado no WordPress](https://full.services/wp-fixer/corrigir-schema-markup-quebrado-wordpress/)
- [Como corrigir robots.txt bloqueando páginas importantes](https://full.services/wp-fixer/corrigir-robots-txt-bloqueio-wordpress/)
- [Como corrigir sitemap XML com erro no WordPress](https://full.services/wp-fixer/corrigir-sitemap-xml-erro-wordpress/)

## Causa

- O módulo LLMS Txt esta desligado no Rank Math SEO -> Dashboard: enquanto o toggle do módulo não for ativado, o plugin não registra a rota /llms.txt nem gera o arquivo.
- O arquivo nunca foi configurado em Rank Math SEO -> General Settings -> Edit llms.txt; pela doc oficial o llms.txt nasce vazio até você selecionar os tipos de post e salvar, entao ele carrega em branco.
- As regras de reescrita (rewrite rules) do WordPress estão defasadas e não incluem a rota virtual /llms.txt, fazendo a URL cair no 404 mesmo com o módulo ativo; isso ocorre tipico após ativar o módulo sem regravar os permalinks.
- A estrutura de links permanentes esta como 'Padrão' (plain, com ?p=123); sem permalinks amigaveis o WordPress não resolve a rota virtual /llms.txt servida pelo Rank Math.
- Um plugin de cache de página ou a CDN guardou uma resposta 404 antiga de /llms.txt e continua entregando essa versão em cache, mesmo após o arquivo passar a existir.
- Todo o conteúdo elegivel esta marcado como noindex: a doc do Rank Math diz que posts noindex são excluidos do llms.txt, entao o arquivo e gerado, porém sem itens para listar.

## Como resolver

1. Ative o módulo LLMS Txt no Rank Math: No painel, abra o Dashboard do Rank Math, localize o módulo LLMS Txt e ligue o toggle. Esse módulo e o que registra a rota /llms.txt e habilita a tela de edição do arquivo. Confirme antes que você esta na versão mais recente do Rank Math, porque o recurso so existe nas versões novas.

```
Painel WP -> Rank Math SEO -> Dashboard
Localize o módulo 'LLMS Txt' e ligue o toggle (On)
Painel WP -> Plugins -> atualize o Rank Math para a versão mais recente, se houver atualização
```

2. Configure e salve o conteúdo em Editar llms.txt: O arquivo nasce vazio até ser configurado. Abra a tela Edit llms.txt, selecione os tipos de post (Posts, Páginas) e taxonomias que devem entrar, ajuste o limite de itens (o padrão e 100) e clique em Salvar. So depois de salvar o Rank Math passa a montar o conteúdo do /llms.txt.

```
Painel WP -> Rank Math SEO -> General Settings -> Edit llms.txt
Marque os tipos de post e taxonomias a incluir (Posts, Páginas, Categorias)
Ajuste o limite de itens (padrão: 100) e clique em 'Save Changes'
```

3. Regrave os links permanentes para criar a rota virtual: O /llms.txt e um arquivo virtual servido pelas regras de reescrita. Garanta uma estrutura de permalinks amigavel (qualquer opção diferente de 'Padrão') e clique em Salvar na tela de Links Permanentes; isso forca o WordPress a regravar as regras e registrar a rota /llms.txt, eliminando o 404.

```
Painel WP -> Configurações -> Links Permanentes
Escolha uma estrutura amigavel (ex.: 'Nome do post'), não deixe em 'Padrão'
Clique em 'Salvar alterações' (mesmo sem mudar nada, isso regrava as rewrite rules)
```

4. Limpe o cache de página e da CDN: Se o /llms.txt ainda retorna 404 ou vem vazio depois dos passos acima, uma resposta antiga pode estar em cache. Limpe o cache do plugin de cache e da CDN e teste a URL em uma aba anonima do navegador para não pegar o cache local.

```
Limpe o cache do seu plugin de cache (ex.: WP Rocket -> Limpar cache)
Purgue o cache da CDN, se usar (ex.: Cloudflare -> Caching -> Purge Everything)
Abra https://seusite.com/llms.txt em uma aba anonima para validar
```

5. Confirme que existe conteúdo indexavel para listar: O Rank Math exclui posts em noindex do llms.txt. Se o arquivo gera mas vem sem itens, verifique se os posts e páginas que deveriam aparecer não estão com 'Não indexar' ligado nas configurações individuais de SEO ou na configuração global de tipos de post.

```
Abra um post que deveria aparecer -> aba Rank Math -> Avancado -> confirme 'Indexar' (sem noindex)
Painel WP -> Rank Math SEO -> Titles & Meta -> verifique se o tipo de post não esta global como noindex
```


## Código

```php
<?php
// Regrava as regras de reescrita uma unica vez para registrar a rota virtual /llms.txt.
// Cole no functions.php do tema filho, carregue qualquer pagina do admin e remova depois.
add_action( 'admin_init', function () {
    if ( get_option( 'full_llms_txt_flushed' ) ) {
        return;
    }
    flush_rewrite_rules( false );
    update_option( 'full_llms_txt_flushed', 1 );
} );
```

## Perguntas frequentes

### Por que o /llms.txt do Rank Math retorna 404

Quase sempre porque o módulo LLMS Txt esta desligado ou as regras de reescrita do WordPress não foram atualizadas. Ative o módulo no Dashboard do Rank Math e depois salve os Links Permanentes em Configurações para regravar as rewrite rules e registrar a rota virtual /llms.txt.

### Onde fica a configuração do llms.txt no Rank Math

Primeiro ative o módulo em Rank Math SEO -> Dashboard, ligando o toggle 'LLMS Txt'. Depois a edição do conteúdo aparece em Rank Math SEO -> General Settings -> Edit llms.txt, onde você escolhe tipos de post, taxonomias e o limite de itens.

### Por que o arquivo llms.txt gera mas vem vazio

A documentação do Rank Math diz que o arquivo nasce vazio até ser configurado. Abra Edit llms.txt, selecione os tipos de post e taxonomias e salve. Se ainda vier vazio, verifique se o conteúdo elegivel não esta todo marcado como noindex, pois posts noindex são excluidos.

### Preciso do Rank Math PRO para usar o llms.txt

O recurso de llms.txt aparece nas versões recentes do Rank Math pelo módulo LLMS Txt. O ponto crítico para ele funcionar e estar na versão mais atual do plugin e com o módulo ativado; se a opção não surge, atualize o Rank Math antes de qualquer outra coisa.

### O llms.txt e um arquivo real ou virtual no WordPress

E virtual. O Rank Math não grava um arquivo fisico na pasta do site; ele gera o conteúdo dinamicamente e serve em /llms.txt pelas regras de reescrita do WordPress. Por isso ele depende de permalinks amigaveis e de rewrite rules atualizadas para resolver.

### Posts com noindex aparecem no llms.txt

Não. Segundo o Rank Math, posts marcados como noindex são excluidos automaticamente do llms.txt. Se você quer que uma página apareca no arquivo, confirme que ela esta definida como indexavel nas configurações de SEO do Rank Math.

### O que e o arquivo llms.txt e para que serve

E um arquivo em Markdown servido na raiz do site que aponta modelos de IA como ChatGPT, Gemini e Claude para o conteúdo mais importante. Ele e uma proposta, ainda não um padrão oficial, entao a adocao varia entre as plataformas de IA, mas já ajuda a guiar assistentes ao seu conteúdo.

### Limpei o cache e o llms.txt continua em 404, o que fazer

Volte aos Links Permanentes e clique em Salvar para forcar a regravacao das regras de reescrita, depois purgue o cache do plugin e da CDN e teste em aba anonima. Se ainda falhar, confirme que o módulo LLMS Txt esta realmente ativo e que o Rank Math esta atualizado.

**Fonte:** [Rank Math — How to Use the llms.txt Feature](https://rankmath.com/kb/llms-txt/)