Neste artigo
Um shortcode é uma macro entre colchetes que o WordPress troca por conteúdo dinâmico quando a página carrega, e saber como usar shortcodes no WordPress economiza HTML repetido em cada post. Ele serve para inserir uma galeria, um formulário ou um vídeo com uma linha de texto. Neste guia você vai entender o que é o recurso, ver os shortcodes nativos, aprender a inserir em posts e widgets, criar o seu próprio com add_shortcode no functions.php e usar tudo dentro do bloco do Gutenberg. Para uma visão dos plugins que ampliam esse recurso, o hub de plugins úteis para WordPress reúne as opções testadas pela FULL. O caminho é didático e vale tanto para quem usa o editor clássico quanto para quem já migrou para os blocos.
Primeiros passos: O que é um shortcode e onde ele funciona
Um shortcode é um marcador entre colchetes que o WordPress processa por um filtro antes de exibir a página, devolvendo HTML no lugar do código. O recurso é nativo desde a versão 2.5, de , e funciona em qualquer tema, sem depender de plugin externo.
A tabela abaixo resume os três cenários de uso que este tutorial cobre, do mais simples ao que exige código. Cada linha responde uma dúvida prática de quem está começando.
| Cenário | Onde se aplica | Nível exigido |
|---|---|---|
| Shortcode nativo | Posts, páginas e widgets, sem instalar nada | Iniciante |
| Plugin de shortcode | Biblioteca pronta de botões, abas e colunas | Iniciante |
| Shortcode próprio | functions.php do tema ou plugin de snippets | Intermediário |
Os três funcionam no mesmo lugar: onde o WordPress aceita conteúdo, o shortcode é interpretado. A diferença está em quem fornece o código por trás do colchete.
Os shortcodes nativos do WordPress e como inseri-los
O WordPress traz seis shortcodes nativos prontos para uso, sem plugin nenhum: , , , [vídeo], e . Para inserir, você abre um post, digita o marcador entre colchetes no corpo do conteúdo e pública; o site troca o código pelo resultado quando a página carrega.
No editor clássico, basta colar o texto; no Gutenberg, o ideal é usar o bloco Shortcode dedicado, que você adiciona pelo menu de blocos. O é o mais conhecido e aceita atributos como ids="12,34,56" para escolher imagens específicas e columns="3" para definir a grade. Esses atributos sempre chegam em minúsculas ao processador, então é lido como ids. Se você ainda organiza barras laterais, vale revisar como adicionar e usar widgets no WordPress, porque widgets e shortcodes se cruzam o tempo todo.
Como inserir um shortcode em posts, páginas e widgets
Inserir um shortcode leva menos de 1 minuto e o processo muda conforme o local. Em posts e páginas, o caminho é digitar o código entre colchetes no editor e salvar; o WordPress troca o marcador pelo conteúdo quando alguém abre a URL.
Em widgets, desde a versão 4.9, de , a área de widgets processa shortcodes automaticamente, então você cola o código num widget de texto ou HTML e ele renderiza igual a um post. Em menus e títulos o recurso não roda por padrão, o que evita brechas de segurança. Esse comportamento é o mesmo que o WordPress aplica aos antigos códigos de acesso no WordPress, o termo em português para shortcode que você ainda encontra em conteúdos mais antigos.
Legenda: o bloco Shortcode dedicado evita que o código seja escapado como texto comum.
Plugins de shortcode: Bibliotecas prontas para quem não escreve código
Plugins de shortcode entregam dezenas de marcadores prontos para quem não escreve código, e o Shortcodes Ultimate lidera a categoria com mais de 600 mil instalações ativas no repositório oficial. Ele adiciona botões, abas, colunas responsivas, contadores e caixas de destaque, todos acionados por um shortcode visual.
Outros nomes fortes são o Woody Code Snippets, voltado a quem cria os próprios marcadores, e o Shortcoder, que transforma blocos de HTML em shortcodes reutilizáveis. A vantagem é velocidade: você instala, escolhe o componente e cola o código. A desvantagem aparece quando o plugin some, porque os shortcodes deixam de funcionar e o texto bruto fica exposto no post. Por isso a FULL recomenda registrar no editor de CSS direto do painel WordPress só o que for visual, e reservar shortcodes para conteúdo que precisa de lógica.
Passo a passo: Criar seu próprio shortcode com add_shortcode
Criar um shortcode próprio exige apenas 1 função em PHP e a chamada add_shortcode, que tem a assinatura oficial add_shortcode( string $tag, callable $callback ). Segundo a documentação para desenvolvedores do WordPress (2026), o callback recebe 3 argumentos e deve sempre retornar o texto, nunca usar echo para imprimir.
O callback recebe $atts, $content e o nome da tag, e o motivo do return é simples: o shortcode age como um filtro, então imprimir direto joga a saída para fora do lugar. Os três passos abaixo cobrem o registro mínimo seguro. Cada passo é um bloco de código que você cola no functions.php do tema filho ou em um plugin de snippets como o Code Snippets.
Passo 1: Escreva a função de callback em PHP
Crie uma função que monte o HTML e o devolva com return. O nome da tag não pode ter espaços nem os caracteres reservados < > & / [ ] =, e o ideal é prefixar para evitar colisão com outro plugin. Um exemplo simples que devolve o ano atual fica assim: function full_ano_atual() { return date('Y'); }. Repare que a função termina com return, não com echo, porque imprimir direto jogaria o valor para o topo da página, fora do parágrafo onde o código aparece.
Passo 2: Registre a função com add_shortcode
Conecte a função a uma tag com add_shortcode('ano', 'full_ano_atual');. A partir daí, escrever [ano] em qualquer post exibe o ano corrente. Como existe apenas um gancho por shortcode, se outro plugin registrar a mesma tag ano, o último registro vence e sobrescreve o seu. Por isso o prefixo no nome da função e numa tag mais específica, como [full_ano], reduz o risco de conflito em sites com muitos plugins.
Passo 3: Use atributos com shortcode_atts
Para aceitar parâmetros, leia o array $atts e defina padrões com shortcode_atts. Assim [saudacao nome="Ana"] passa a chave nome para sua função, sempre em minúsculas. A função shortcode_atts mescla os atributos enviados com os padrões que você definir, evitando erro quando o usuário esquece um parâmetro. Quem prefere uma interface visual em vez de PHP pode gerar marcadores parecidos com o criar shortcodes customizados com o JetEngine, que monta a lógica sem escrever a função na mão.
Legenda: a chamada add_shortcode liga a tag à função de callback que retorna o conteúdo.
Como usar shortcodes no bloco do Gutenberg sem quebrar a renderização
No Gutenberg, o jeito certo de usar shortcodes é por 1 bloco específico, o bloco Shortcode, e não pelo bloco de código, porque os dois tratam os colchetes de forma oposta. O bloco Shortcode processa o marcador e devolve o HTML final; o bloco Código exibe os colchetes como texto literal na tela.
Para adicionar, clique no ícone de mais, busque por Shortcode e cole o marcador dentro. Um sintoma comum no suporte da FULL é o shortcode que some depois da migração do editor clássico para o Gutenberg: na maioria dos casos o texto caiu dentro de um bloco Parágrafo que escapou os colchetes, e mover o conteúdo para o bloco Shortcode restaura a saída sem tocar no código. Quem quer entender melhor a lógica de blocos pode ler o editor de blocos Gutenberg do WordPress antes de seguir.
Por que usar a plataforma FULL para gerenciar plugins de shortcode
Manter plugins de shortcode atualizados em vários sites consome tempo, e a plataforma FULL entra como alternativa de gestão no plano PRO, por R$849 ao ano, com ativação em 1 clique dos plugins premium da curadoria em até 10 sites. Diluído pela base, isso dá R$85 por site.
A gente vê no suporte que boa parte dos sites que perdem um shortcode na tela estava com plugin desatualizado ou desativado por engano, e a ativação central reduz esse risco. Conheça os planos em FULL.services/planos e compare com o custo de licenciar cada plugin de forma avulsa.
Perguntas frequentes sobre shortcodes no WordPress
O que é um shortcode no WordPress e para que serve?
Um shortcode é uma macro entre colchetes, como , que o WordPress troca por conteúdo dinâmico quando a página carrega. Ele serve para inserir galerias, vídeos, formulários ou botões sem repetir HTML em cada post. O recurso é nativo desde a versão 2.5 de 2008 e funciona em qualquer tema, em posts, páginas e widgets de texto.
Por que um shortcode aparece como texto puro em vez de renderizar?
O shortcode vira texto puro quando o plugin que o criou foi desativado ou quando o marcador caiu num bloco de código no Gutenberg. Sem o plugin registrado, o WordPress não reconhece a tag e exibe os colchetes literais. A correção é reativar o plugin responsável ou mover o conteúdo para o bloco Shortcode dedicado, que processa o marcador corretamente.
É possível criar um shortcode próprio sem instalar nenhum plugin?
Sim, é possível criar um shortcode próprio só com PHP, usando a função add_shortcode no arquivo functions.php do tema filho. Você escreve uma função que retorna o HTML com return, nunca echo, e registra a tag com add_shortcode('ano', 'sua_função'). Nenhum plugin é necessário, mas um tema filho evita perder o código numa atualização do tema.
Qual a diferença entre o bloco Shortcode e o bloco de código no Gutenberg?
A diferença é que o bloco Shortcode processa o marcador e devolve o HTML final, enquanto o bloco Código exibe os colchetes como texto literal na tela. Para ver o resultado de um , use o bloco Shortcode; o bloco Código serve só para mostrar o código-fonte ao leitor. Trocar um pelo outro é a causa mais comum de shortcode que não renderiza.
Quanto custa usar shortcodes em um site WordPress?
Usar shortcodes nativos e criar os seus com add_shortcode é gratuito, porque o recurso faz parte do núcleo do WordPress. O custo só aparece se você optar por plugins premium de shortcode. No bundle da FULL, o plano PRO sai por R$849 ao ano para até dez sites, o que equivale a R$85 por site, ante o licenciamento avulso de cada plugin.
Próximos passos para dominar shortcodes no WordPress
Dominar shortcodes no WordPress significa saber escolher entre os três caminhos conforme a necessidade: o nativo resolve galerias e mídia, o plugin entrega uma biblioteca pronta de componentes visuais e o add_shortcode no functions.php dá controle total quando você precisa de lógica própria. Comece pelos nativos, avance para um plugin como o Shortcodes Ultimate e, quando o site exigir algo sob medida, escreva a função em um tema filho ou plugin de snippets para não perder o código numa atualização. Para continuar aprendendo, o guia os melhores plugins para WordPress reúne tutoriais e reviews num só lugar, e o FULL Academy organiza o conteúdo por trilha. Com o bloco Shortcode do Gutenberg e o cuidado de sempre retornar do callback, você evita os dois erros que mais geram chamado: o marcador escapado e a saída fora do lugar.
