🎉 USE O CUPOM DESCONTO.FULL | 20% OFF acima de R$ 50,00

Como corrigir WPBakery com shortcodes quebrados

Time Full Services Time Full Services
Tipo Page Builders
Nome do erro WPBakery com shortcodes quebrados EN: WPBakery broken shortcodes
Severidade Atenção
Descrição WPBakery com shortcodes quebrados mostra códigos crus como [vc_row] e [vc_column] no lugar do layout montado, porque o plugin que interpreta esses shortcodes não esta ativo ou registrado. A causa quase sempre e o WPBakery (Visual Composer) desativado, embutido num tema que sumiu, ou páginas migradas para um site sem o plugin.

O que é o WPBakery com shortcodes quebrados?

WPBakery Page Builder, antigo Visual Composer, monta páginas usando shortcodes (como [vc_row] e [vc_column]) que ele converte em HTML na hora de exibir. Quando esses shortcodes aparecem quebrados, o WordPress não tem o código que os interpreta: o plugin esta inativo ou ausente. Sem o WPBakery registrando os shortcodes, o WordPress imprime o texto literal em vez de renderizar as colunas e seções.

Como identificar

  • Códigos como “[vc_row]”, “[vc_column]” e “[vc_column_text]” aparecem visiveis no conteúdo da página.
  • O layout some e o conteúdo vira um bloco de texto corrido com os shortcodes no meio.
  • O aviso “This page is using WPBakery Page Builder” some do editor ou não aparece mais.
  • O problema surgiu logo após trocar de tema, migrar o site ou desativar um plugin.
Antes de começar: Antes de remover ou substituir páginas com shortcodes crus, faca backup do banco de dados: o conteúdo continua intacto no banco e volta a renderizar assim que o WPBakery for reativado. Apagar a página perde o layout de forma definitiva.

Como prevenir

  • Prefira instalar o WPBakery como plugin próprio, com licenca registrada, em vez de depender da versão embutida no tema
  • Antes de trocar de tema, confirme se o builder e do tema; se for, planeje a migração do conteúdo
  • Em qualquer migração, leve e ative o WPBakery na mesma versão no site de destino antes de mover as páginas

Causa

  • Plugin WPBakery Page Builder desativado, deixando os shortcodes [vc_*] sem nenhum código que os interprete.
  • WPBakery embutido (bundled) num tema premium que foi trocado, levando junto o plugin que registrava os shortcodes.
  • Páginas migradas para um site onde o WPBakery não foi instalado ou ativado no destino.
  • Licenca do WPBakery embutido expirada ou não registrada, bloqueando a atualização e o funcionamento do plugin.
  • Conflito de versão entre o WPBakery e o WordPress ou o tema após uma atualização parcial.

Como resolver

  1. Confirme se o WPBakery esta ativo: va em Plugins e verifique se o WPBakery Page Builder (ou Visual Composer) aparece e esta ativado. Se estiver inativo, ative-o: os shortcodes voltam a renderizar de imediato.
  2. Reinstale o WPBakery do tema: se o builder vinha embutido no tema antigo, reative aquele tema ou instale o WPBakery via licenca/tema atual. Os shortcodes [vc_*] so funcionam com o plugin presente.
  3. Verifique a migração: se as páginas vieram de outro site, instale e ative o WPBakery no destino com a mesma versão da origem para os shortcodes serem reconhecidos.
  4. Registre a licenca: em WPBakery Page Builder > Product License, ative a licenca para liberar atualizações e o funcionamento pleno do plugin embutido.
  5. Limpe o cache: após reativar o WPBakery, limpe o cache do plugin de cache e do CDN para servir a versão renderizada e não a página com os shortcodes crus.
PHP
// functions.php do tema filho - oculta shortcodes [vc_*] orfaos enquanto o WPBakery nao volta
// Paliativo: evita exibir o codigo cru ao visitante; NAO substitui reinstalar o plugin
add_filter( 'the_content', function( $content ) {
  if ( ! defined( 'WPB_VC_VERSION' ) ) { // WPBakery ausente/inativo
    $content = preg_replace( '/[/?vc_[^]]*]/', '', $content );
  }
  return $content;
}, 5 );

Perguntas frequentes

Por que os shortcodes [vc_row] aparecem no texto?
Porque o WPBakery, que interpreta esses shortcodes, esta inativo ou ausente. Sem ele, o WordPress imprime o código literal em vez de montar o layout. Reative ou reinstale o WPBakery e os shortcodes voltam a renderizar como colunas e seções.
Perdi o conteúdo da página com os shortcodes quebrados?
Não. O conteúdo continua salvo no banco de dados, apenas exibido cru porque falta o plugin para interpreta-lo. Assim que o WPBakery for reativado, o layout volta inteiro. Nunca apague a página pensando que os dados sumiram.
O WPBakery veio com o tema. Como reinstalo?
Se o builder era embutido no tema, ele depende do tema ou da licenca dele. Reative o tema antigo para recuperar o acesso, exporte o conteúdo, ou adquira o WPBakery como plugin independente e ative-o para registrar os shortcodes de novo.
Os shortcodes quebraram depois de migrar o site. Por que?
Porque o WPBakery não foi instalado ou ativado no site de destino. Os shortcodes vieram no conteúdo, mas o plugin que os interpreta ficou para tras. Instale e ative o WPBakery na mesma versão no novo site para corrigir.
Posso trocar o WPBakery por outro builder?
Pode, mas os shortcodes [vc_*] não são reconhecidos por Elementor ou Gutenberg. Você precisara reconstruir as páginas no novo builder. Enquanto migra, mantenha o WPBakery ativo para o conteúdo antigo continuar renderizando.
Limpar o cache resolve os shortcodes crus?
Sozinho, não. Primeiro reative o WPBakery; depois limpe o cache do plugin de cache e do CDN para descartar a versão salva com os shortcodes crus. Sem o plugin ativo, limpar o cache so reexibe o mesmo conteúdo quebrado.

Seja PRO.

Tenha acesso a snippets de código premium — PHP, JavaScript, CSS e HTML prontos para usar em seus projetos.

Conhecer o plano Pro →

Uma nova era para o WordPress.

A FULL Services redefine o CMS com uma arquitetura modular que transforma o WordPress em um motor de crescimento digital. 

Painéis personalizados

Um novo nível de controle para o WordPress. Acompanhe métricas, automações e evolução do seu site em um único painel visual.

A força por trás de grandes marcas

Para agências, estúdios e profissionais independentes que desejam oferecer soluções de alto nível com sua própria marca.

Componentes

Hero Sections

30 componentes

Seções de CTA

14 componentes

Login

14 componentes

Blog

14 componentes

Cabeçalhos

24 componentes

Seções de FAQ

53 componentes

Cadastro

53 componentes

Blog individual

53 componentes

Rodapés

28 componentes

Seções de contato

27 componentes

Seções de preços

27 componentes

Faixas

27 componentes

Portfólio

16 componentes

Seções de equipe

12 componentes

Números

12 componentes

Logotipos

12 componentes