Las descripciones de productos de WooCommerce contienen con frecuencia shortcodes de WordPress — marcadores de posición como [su_button], [vc_row] o [product_page] — insertados por plugins de maquetadores de páginas o extensiones de WooCommerce. Cuando se exportan e importan a Shopify, estos shortcodes se muestran como texto sin procesar en las páginas de producto, con este aspecto: [product_page id="123"]. Esta guía explica cómo identificar, limpiar y reemplazar todo el contenido de shortcodes antes de migrar a Shopify.

Shortcodes comunes de WooCommerce en descripciones de productos

Shortcodes de maquetadores de páginas (se muestran como texto roto en Shopify)

[vc_row], [vc_column], [vc_column_text] — WPBakery / Visual Composer
[et_pb_section], [et_pb_row], [et_pb_text] — Divi Builder
[fusion_builder_container], [fusion_text] — Avada / Fusion Builder
[tatsu_section], [tatsu_row] — maquetador Tatsu
Elementor no usa shortcodes (utiliza metadatos de post en la BD), pero algunos plugins de Elementor inyectan shortcodes

Shortcodes de plugins

[su_button], [su_tabs], [su_accordion], [su_table] — Shortcodes Ultimate
[wc_cart_button], [add_to_cart] — shortcodes de WooCommerce en descripciones
[product_page id=""] — referencia a producto incrustada
[wp_review], [wpreview] — plugins de reseñas
[tablepress id=""] — tablas de TablePress
[contact-form-7] — formularios de contacto incrustados en descripciones de productos
[gravityform id=""] — Gravity Forms en descripciones
[pdf-embedder], [pdfviewer] — plugins de incrustación de PDF
[video_lightbox_youtube], [youtube] — plugins de vídeo

Shortcodes nativos de WordPress/WooCommerce

[caption] — shortcode de pie de foto de imagen de WordPress (se muestra como texto sin formato)
[gallery] — shortcode de galería de WordPress
[woocommerce_messages] — muestra mensajes del proceso de pago
[recent_products], [featured_products] — listas de productos dinámicas de WC

Cómo encontrar shortcodes en tu base de datos de WooCommerce

Método 1: consulta directa de MySQL (más completa)

-- Encuentra todos los productos con shortcodes en descripción o descripción corta
SELECT ID, post_title, post_content, post_excerpt
FROM wp_posts
WHERE post_type = 'product'
AND post_status = 'publish'
AND (
  post_content LIKE '%[%]%'
  OR post_excerpt LIKE '%[%]%'
);

Esto encuentra cualquier contenido de publicación que contenga corchetes — exporta los resultados para revisar qué shortcodes están presentes.

Método 2: exportación de WooCommerce + análisis de texto

Exporta productos a CSV mediante Admin de WooCommerce → Productos → Exportar
Abre el CSV en Excel o Google Sheets
Usa BUSCAR para buscar "[" en las columnas Descripción y Descripción Corta
O bien: usa un editor de texto con expresiones regulares — busca \[[a-zA-Z_]+[^\]]*\] para encontrar patrones de shortcode

Método 3: WordPress CLI (WP-CLI)

wp post list --post_type=product --fields=ID,post_title,post_content \
  --post_status=publish --format=csv | grep "\["

Estrategias de eliminación masiva de shortcodes

Opción 1: buscar y reemplazar con SQL (directamente en la BD)

-- Eliminar shortcodes de WPBakery de las descripciones de productos
-- ADVERTENCIA: Haz siempre una copia de seguridad de la base de datos antes de ejecutar actualizaciones SQL

UPDATE wp_posts
SET post_content = REGEXP_REPLACE(
  post_content,
  '\\[vc_[^\\]]*\\]',
  ''
)
WHERE post_type = 'product';

-- Repite para otros patrones de shortcode

Opción 2: plugin Better Search Replace (administración de WordPress)

Instala Better Search Replace en el administrador de WooCommerce
Ejecuta buscar y reemplazar con expresiones regulares en la tabla wp_posts
Patrón para encontrar y eliminar WPBakery: /\[vc_[^\]]+\]/ → reemplazar con cadena vacía
Ejecuta primero en modo de prueba para contar ocurrencias antes de confirmar

Opción 3: script PHP personalizado (recomendado para catálogos grandes)

<?php
// run-cleanup.php — ejecutar una vez, eliminar después
require 'wp-load.php';

$products = get_posts(['post_type' => 'product', 'posts_per_page' => -1]);

foreach ($products as $product) {
  $clean_content = $product->post_content;

  // Eliminar shortcodes de WPBakery
  $clean_content = preg_replace('/\\[vc_[^\\]]*\\]/', '', $clean_content);
  $clean_content = preg_replace('/\\[\\/vc_[^\\]]*\\]/', '', $clean_content);

  // Eliminar Shortcodes Ultimate
  $clean_content = preg_replace('/\\[su_[^\\]]*\\]/', '', $clean_content);
  $clean_content = preg_replace('/\\[\\/su_[^\\]]*\\]/', '', $clean_content);

  // Eliminar incrustaciones de WooCommerce
  $clean_content = preg_replace('/\\[wc_[^\\]]*\\]/', '', $clean_content);

  if ($clean_content !== $product->post_content) {
    wp_update_post(['ID' => $product->ID, 'post_content' => $clean_content]);
    echo "Limpiado: " . $product->post_title . "\n";
  }
}
echo "Hecho.";
?>

Reemplazar shortcodes con HTML compatible con Shopify

Simplemente eliminar shortcodes supone perder contenido. Para los shortcodes que generan contenido real, reemplázalos con HTML estático:

Acordeón / pestañas (su_accordion → HTML details/summary)

<!-- WooCommerce: [su_accordion][su_spoiler title="Características"] Contenido [/su_spoiler][/su_accordion] -->

<!-- Reemplazo compatible con Shopify: -->
<details>
  <summary>Características</summary>
  <p>Contenido</p>
</details>

Tablas (TablePress → tabla HTML)

<!-- WooCommerce: [tablepress id="3"] -->
<!-- Exporta la tabla desde TablePress → exporta a tabla HTML → pega el HTML estático en la descripción de Shopify -->
<table>
  <thead><tr><th>Columna 1</th><th>Columna 2</th></tr></thead>
  <tbody><tr><td>Valor</td><td>Valor</td></tr></tbody>
</table>

Vídeos de YouTube (shortcodes de vídeo → iframe)

<!-- WooCommerce: [youtube id="VIDEOID"] -->
<!-- Reemplazar con: -->
<iframe
  src="https://www.youtube.com/embed/VIDEOID"
  width="560"
  height="315"
  allowfullscreen>
</iframe>

Incrustación de PDF (pdf-embedder → enlace de visor de Google Docs)

<!-- WooCommerce: [pdf-embedder url="https://...archivo.pdf"] -->
<!-- Shopify: usa un enlace simple o el visor de Google Docs -->
<a href="https://tucdn.com/archivo.pdf" target="_blank">Descargar PDF (abre en nueva pestaña)</a>

Contenido de WPBakery / Divi en descripciones de productos

Los productos editados en WPBakery o Divi almacenan su contenido como una mezcla de shortcodes y HTML puro. Después de eliminar los envoltorios de shortcode, te queda el contenido de texto real. Sin embargo, el diseño (columnas, secciones) se pierde — necesitas reconstruir el contenido como HTML limpio:

Visualiza cada página de producto afectada en WooCommerce antes de la migración y haz capturas de pantalla del diseño renderizado
Usa las capturas de pantalla como referencia para reconstruir el contenido como HTML limpio
Alternativamente: usa la exportación de Divi/WPBakery para generar una instantánea HTML renderizada del contenido
Para catálogos grandes: prioriza los productos más vendidos (el 20% superior por ingresos) para la revisión manual de contenido; elimina en masa el resto

Saneamiento de HTML: otros artefactos a limpiar

Más allá de los shortcodes, las exportaciones de productos de WooCommerce suelen contener:

Clases CSS de WordPress inline: class="aligncenter", class="wp-image-123" — inofensivas pero pueden eliminarse para mayor limpieza
IDs de imagen de WordPress: <img class="wp-image-456"> — atributo específico de WordPress, no necesario en Shopify
URLs absolutas de WordPress: src="https://tuviendjaantigua.com/wp-content/uploads/..." — siguen funcionando después de la migración si el hosting de WP continúa activo, pero deben subirse a Shopify Files para mayor permanencia
Etiquetas de párrafo vacías: el editor de WP suele insertar <p> </p> para espaciado — estas crean espacios visuales en las descripciones de productos de Shopify
Etiquetas de script: algunos plugins incrustan etiquetas <script> en las descripciones. Shopify las elimina por seguridad, pero el contenido resultante puede verse roto.

Lista de verificación para la limpieza de shortcodes

Haz una copia de seguridad de la base de datos de WooCommerce antes de cualquier operación masiva
Exporta el CSV de productos y busca los patrones de shortcode [ y ]
Categoriza los shortcodes encontrados: maquetador de páginas vs plugin vs WC nativo vs vídeo/medios
Elimina los envoltorios de maquetadores de páginas (vc_, et_pb_, fusion_) — extrae el contenido interior
Reemplaza los shortcodes de acordeón con elementos HTML details/summary
Exporta y reemplaza las tablas de TablePress con tablas HTML estáticas
Reemplaza los shortcodes de vídeo con iframes estándar
Reemplaza las incrustaciones de PDF con enlaces de descarga
Ejecuta el script de limpieza y vuelve a exportar a CSV para la importación en Shopify
Comprueba el 10% de los productos: visualiza el contenido renderizado en la tienda de Shopify antes de lanzar
Para productos complejos de Divi/WPBakery: reconstrucción manual del contenido desde captura de pantalla de referencia para los artículos más vendidos

El paso de limpieza de shortcodes es tedioso pero esencial — el texto de shortcode sin procesar visible en las páginas de producto es poco profesional y daña la tasa de conversión de inmediato. La fase de descubrimiento (encontrar todos los productos afectados) suele ser rápida. La limpieza real escala en función del uso extensivo de los maquetadores de páginas. Una tienda con 500 productos simples donde solo el 10% usó Shortcodes Ultimate para pestañas de acordeón es medio día de trabajo de limpieza. Una tienda donde cada descripción de producto se construyó en Divi puede requerir una semana completa de trabajo de migración de contenido.

Limpieza de shortcodes de WooCommerce en descripciones de productos para Shopify (2026)