# Como corrigir as permissões do Role Manager no Rank Math

As permissões do Role Manager no Rank Math controlam quais funções do plugin cada perfil do WordPress enxerga; quando mal configuradas ou com o módulo desativado, editores e autores perdem menus inteiros e veem o erro de acesso negado.

## O que é permissões do Role Manager no Rank Math?

O Role Manager do Rank Math é o módulo que define, por perfil de usuário do WordPress, quais funções do plugin cada um pode acessar. Em vez de liberar tudo para qualquer Editor ou Autor, o administrador habilita ou desabilita capacidades individuais como Titles & Meta, General Settings, Sitemap, 404 Monitor, Link Builder, Redirections, Analytics, On-Page Analysis, Content AI e o próprio Role Manager. A configuração fica em Rank Math SEO e o ajuste é salvo no botão Update Capabilities.

Segundo a documentação oficial do Rank Math, quando uma capacidade é desligada para um perfil, a função correspondente some do menu daquele usuário e qualquer tentativa de acesso direto pela URL retorna a mensagem de acesso negado. É exatamente esse o sintoma percebido como erro: um Editor que deixou de ver Redirections ou um Autor sem acesso ao painel de SEO não estão diante de um bug, e sim de uma permissão que foi removida no Role Manager, ou do módulo que nunca foi ativado em Dashboard.

## Como identificar

- Um Editor ou Autor abre o WordPress e o menu Rank Math, ou submenus como Redirections, 404 Monitor e Analytics, simplesmente não aparece para ele.
- Ao acessar a URL de uma tela do Rank Math, o usuário recebe a mensagem 'Sorry, you're not allowed to access this page'.
- O item Role Manager não existe no submenu do Rank Math nem para o administrador, indicando que o módulo está desativado em Dashboard.
- As metaboxes de SEO do Rank Math somem da tela de edição de posts apenas para determinados perfis, enquanto o administrador continua vendo tudo.
- Depois de marcar ou desmarcar capacidades, nada muda na prática porque a alteração foi feita sem clicar em Update Capabilities.

**Antes de começar:** Antes de mexer nas capacidades em produção, anote a configuração atual de cada perfil ou faça um backup do banco de dados. Liberar capacidades sensíveis como Role Manager e General Settings para Editores e Autores amplia o acesso desses usuários, então conceda apenas o que cada equipe realmente precisa.

## Como prevenir

- Defina uma política clara de quais funções do Rank Math cada perfil precisa antes de ajustar o Role Manager, em vez de liberar tudo por padrão.
- Mantenha a capacidade Role Manager restrita a administradores de confiança, para que ninguém altere permissões dos demais perfis sem querer.
- Documente a configuração de capacidades por perfil e revise após cada novo plugin que crie perfis personalizados no site.
- Ao remover o acesso de um perfil, avise a equipe afetada, já que o menu some e o acesso direto passa a retornar a mensagem de acesso negado.

Erros relacionados

- [Como corrigir Breadcrumbs duplicados entre Astra Pro e Rank Math](https://full.services/wp-fixer/corrigir-breadcrumbs-duplicados-astra-pro-rank-math/)
- [Como corrigir schema markup quebrado no WordPress](https://full.services/wp-fixer/corrigir-schema-markup-quebrado-wordpress/)
- [Como corrigir meta description não aparecendo no Google](https://full.services/wp-fixer/corrigir-meta-description-nao-aparece-wordpress/)

## Causa

- O módulo Role Manager está desativado em Rank Math SEO -> Dashboard -> Modules, então não existe submenu para ajustar permissões e os padrões do plugin permanecem em vigor.
- A capacidade específica (por exemplo Redirections ou Analytics) foi desmarcada para o perfil Editor ou Autor na tela do Role Manager, removendo o menu correspondente daquele usuário.
- As caixas foram marcadas corretamente, mas o botão Update Capabilities no fim da página não foi clicado, então a configuração não chegou a ser salva.
- A proteção do próprio Role Manager continua desligada (padrão para administradores), e outro administrador alterou capacidades sem perceber o impacto nos demais perfis.
- Um perfil personalizado criado por outro plugin não recebeu nenhuma capacidade do Rank Math no Role Manager, ficando sem acesso a qualquer função do plugin por padrão.

## Como resolver

1. Confirme que o módulo Role Manager está ativo: Sem o módulo ativo não há tela de permissões e o Rank Math usa os padrões internos. Ative o Role Manager no Dashboard de módulos do plugin antes de qualquer ajuste.

```
Painel WP -> Rank Math SEO -> Dashboard
Na aba Modules, ative o módulo 'Role Manager'
```

2. Abra a tela do Role Manager: Com o módulo ativo, o item Role Manager passa a existir no submenu do Rank Math. É nessa tela que cada capacidade é liberada por perfil.

```
Painel WP -> passe o mouse sobre o menu Rank Math
Clique em 'Role Manager' no submenu
```

3. Libere as capacidades para o perfil afetado: Localize a coluna do perfil que perdeu acesso (Editor, Autor ou perfil personalizado) e marque as capacidades que ele deve ter, como Titles & Meta, Redirections ou Analytics. Use o botão Toggle All para liberar tudo de uma vez quando fizer sentido.

```
Na linha de cada capacidade, marque a caixa do perfil afetado
Use 'Toggle All' para marcar todas as capacidades de um perfil
```

4. Salve com Update Capabilities: A alteração só passa a valer depois de salva. Clique em Update Capabilities no fim da página para aplicar as permissões imediatamente aos perfis ajustados.

```
Role até o fim da tela do Role Manager
Clique no botão 'Update Capabilities'
```

5. Valide com um usuário do perfil ajustado: Entre com uma conta do perfil corrigido (ou peça ao usuário) e confirme que os menus voltaram e que a mensagem de acesso negado desapareceu. Se preferir restaurar tudo ao padrão, use a opção Reset do Role Manager.

```
Faça login com um usuário do perfil ajustado
Confirme que o menu Rank Math e os submenus liberados aparecem
Se necessário, use 'Reset' para voltar aos padrões do Role Manager
```


## Código

```php
<?php
// Concede capacidades do Rank Math a um perfil via codigo (alternativa ao Role Manager).
add_action( 'admin_init', 'full_grant_rank_math_caps' );
function full_grant_rank_math_caps() {
    $role = get_role( 'editor' );
    if ( ! $role ) {
        return;
    }
    $caps = array(
        'rank_math_titles',        // Titles & Meta
        'rank_math_redirections',  // Redirections
        'rank_math_analytics',     // Analytics
        'rank_math_onpage_general' // On-Page Analysis
    );
    foreach ( $caps as $cap ) {
        if ( ! $role->has_cap( $cap ) ) {
            $role->add_cap( $cap );
        }
    }
}
```

## Perguntas frequentes

### Por que o menu do Rank Math sumiu para o meu Editor

Quase sempre a capacidade correspondente foi desmarcada para o perfil Editor no Role Manager. Quando uma função é desligada, ela some do menu daquele usuário. Reabra Rank Math SEO -> Role Manager, marque a capacidade na coluna do Editor e clique em Update Capabilities.

### Onde fica o Role Manager do Rank Math

O Role Manager é um módulo. Ative-o primeiro em Rank Math SEO -> Dashboard, na aba Modules. Depois de ativo, passe o mouse sobre o menu Rank Math e clique em Role Manager no submenu para abrir a tela de permissões por perfil.

### O que significa o erro 'Sorry, you're not allowed to access this page' no Rank Math

Segundo a documentação do Rank Math, essa mensagem aparece quando o usuário tenta acessar uma função cuja capacidade foi desativada para o perfil dele no Role Manager. Libere a capacidade desejada para esse perfil e salve com Update Capabilities.

### Como libero Redirections do Rank Math só para um perfil

Na tela do Role Manager, encontre a linha da capacidade Redirections e marque apenas a coluna do perfil que deve usá-la. Deixe as demais colunas desmarcadas e clique em Update Capabilities para aplicar a permissão somente àquele perfil.

### Minhas alterações no Role Manager não fazem efeito, por quê

Marcar ou desmarcar as caixas não basta. A configuração só é gravada ao clicar no botão Update Capabilities no fim da página. Reabra o Role Manager, refaça os ajustes e salve antes de testar com o usuário afetado.

### Como volto o Role Manager para a configuração padrão

Na tela do Role Manager existe a opção Reset, que restaura as configurações padrão de permissões do módulo. Use-a quando uma alteração tiver causado bloqueios inesperados e você quiser recomeçar a partir do padrão do plugin.

### O Role Manager funciona com perfis personalizados de outros plugins

Sim. Perfis personalizados criados no site também aparecem nas colunas do Role Manager, ao lado dos perfis padrão do WordPress. Por padrão eles podem nascer sem capacidades do Rank Math, então marque as funções desejadas e salve com Update Capabilities.

**Fonte:** [Rank Math — How to Use the Role Manager](https://rankmath.com/kb/role-manager/)