Como corrigir as permissões do Role Manager no Rank Math
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.
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.
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
- 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' - 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 - 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 - 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' - 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
<?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 );
}
}
}














