Las tiendas WooCommerce construidas con Advanced Custom Fields (ACF), Meta Box o campos personalizados de WordPress a menudo tienen grandes cantidades de datos de producto estructurados que no forman parte del esquema estándar de productos de WooCommerce. Estos datos — ingredientes, especificaciones, certificaciones, dimensiones, fichas técnicas, documentos relacionados — necesitan migrarse a los metacampos de Shopify. Esta guía cubre el proceso técnico de migración.

Enfoques de campos personalizados en WooCommerce

Los datos de campos personalizados en WooCommerce pueden proceder de múltiples fuentes:

ACF (Advanced Custom Fields): El más común — grupos de campos asignados al tipo de publicación "product". Almacena datos en la tabla wp_postmeta de WordPress con claves meta de ACF.
Meta Box: Similar a ACF — grupos de campos con campos tipados (texto, número, select, repetidor, etc.).
Pods: Constructor de tipos de contenido y campos personalizados. A veces se usa junto con WooCommerce.
Atributos de producto de WooCommerce: Función integrada de WooCommerce — almacena atributos en wp_termmeta y en meta del producto. Disponible en el CSV de exportación estándar de WooCommerce.
Campos personalizados de WooCommerce: Metadatos clave-valor simples almacenados mediante llamadas a update_post_meta() desde plugins personalizados.

Resumen de los metacampos de Shopify

Los metacampos de Shopify son almacenes clave-valor adjuntos a los recursos de Shopify (productos, variantes, clientes, pedidos, colecciones). Para la migración de datos de producto, trabajarás principalmente con metacampos a nivel de producto.

Estructura de los metacampos

{
  namespace: "custom",          // o tu propio espacio de nombres, p. ej. "specs", "nutrition"
  key: "ingredients",
  type: "multi_line_text_field",
  value: "Agua, Azúcar, Ácido cítrico"
}

Tipos de metacampos disponibles

Texto: single_line_text_field, multi_line_text_field, rich_text_field
Números: number_integer, number_decimal
Booleano: boolean (verdadero/falso)
Fecha/hora: date, date_time
URL: url
JSON: json (para datos estructurados complejos)
Archivo: file_reference (para imágenes/documentos)
Referencias: product_reference, variant_reference, collection_reference, metaobject_reference
Listas: list.single_line_text_field, list.product_reference, etc.
Dimensiones: dimension (con unidad), volume, weight
Valoración: rating (escala mín./máx.)
Color: color (valor hexadecimal)
Dinero: money

Paso 1: Auditar los campos personalizados de WooCommerce

Antes de migrar, documenta todos los campos personalizados por tipo de producto:

En el panel de administración de WordPress → ACF → Grupos de campos — lista todos los grupos de campos asignados a Productos. Para cada grupo, anota: nombre del campo (slug), tipo de campo, si es de valor único o múltiple.
Exporta una muestra de 10 productos y comprueba los valores de metadatos en el CSV exportado o mediante WP-CLI: wp post meta list {product_id}
Identifica qué campos están rellenados (no vacíos) en la mayoría de los productos frente a campos que existen pero rara vez se usan

Paso 2: Crear definiciones de metacampos en Shopify

Antes de importar datos, crea definiciones de metacampos en el panel de administración de Shopify → Configuración → Datos personalizados → Productos → Añadir definición.

Para cada campo personalizado de WooCommerce, crea una definición de metacampo correspondiente en Shopify:

Elige un espacio de nombres (p. ej., "specs" para especificaciones técnicas, "nutrition" para datos nutricionales)
Clave = versión en snake_case del nombre del campo
Tipo = el tipo de Shopify más cercano al tipo de campo de WooCommerce

Crear definiciones es importante porque: (1) permite la validación de tipos, (2) hace que los campos estén disponibles en el selector de metacampos del editor de temas de Shopify, y (3) permite la edición en la interfaz de administración de estos campos en las páginas de productos.

Paso 3: Exportar datos de campos personalizados de WooCommerce

Mediante la exportación CSV de WooCommerce (para atributos de producto)

Los atributos de producto estándar de WooCommerce aparecen en la exportación CSV predeterminada. Panel de administración de WooCommerce → Productos → Exportar → incluye campos personalizados en la configuración de exportación.

Mediante el plugin de exportación de ACF

Para los campos de ACF, usa "ACF: Advanced Custom Fields - Export" u otro plugin similar para exportar los datos de campos junto con los datos de producto.

Mediante WP-CLI (el más completo)

# Exportar todos los metadatos de publicación para productos
wp post meta list --post_type=product --format=csv > product_meta.csv

# O apuntar a una clave meta específica
wp post meta list --post_type=product --keys=_custom_field_name --format=csv

Mediante consulta directa a la base de datos

-- Exportar campos personalizados para todos los productos
SELECT p.ID, p.post_title, pm.meta_key, pm.meta_value
FROM wp_posts p
JOIN wp_postmeta pm ON p.ID = pm.post_ID
WHERE p.post_type = 'product'
AND pm.meta_key IN ('_ingredients', '_allergens', '_certifications')
ORDER BY p.ID;

Paso 4: Mapear meta_key de WooCommerce al metacampo de Shopify

Construye una tabla de mapeo:

meta_key de WooCommerce	Espacio de nombres de Shopify	Clave de Shopify	Tipo
_ingredients	nutrition	ingredients	multi_line_text_field
_allergens	nutrition	allergens	multi_line_text_field
_certifications	custom	certifications	list.single_line_text_field
_material	specs	material	single_line_text_field
_dimensions	specs	dimensions	single_line_text_field
_data_sheet_url	docs	data_sheet_url	url
_warranty_years	specs	warranty_years	number_integer

Paso 5: Importar metacampos a Shopify

Opción A: Importación CSV desde el panel de administración de Shopify (metacampos)

Panel de administración de Shopify → Productos → Importar → selecciona "Productos y sus metacampos".

Formato CSV para metacampos de producto:

Handle,Title,Metafield: specs.material (single_line_text_field),Metafield: nutrition.ingredients (multi_line_text_field)
blue-widget,Blue Widget,Acero inoxidable,"Agua, Azúcar, Sal"
red-gadget,Red Gadget,Aluminio,"Harina, Mantequilla, Huevos"

El formato del encabezado de columna es: Metafield: namespace.key (type)

Opción B: API de administración de Shopify (programático)

// POST /admin/api/2024-01/products/{product_id}/metafields.json
{
  "metafield": {
    "namespace": "nutrition",
    "key": "ingredients",
    "type": "multi_line_text_field",
    "value": "Agua, Azúcar, Ácido cítrico, Aromas naturales"
  }
}

Para la importación masiva de muchos productos, escribe un script que:

Lea tu CSV de exportación de WooCommerce
Para cada fila, busque el producto de Shopify correspondiente por handle/SKU
Publique los valores de metacampos mediante la API de administración

Opción C: Mapeo de metacampos con k-sync

k-sync puede importar valores de campos personalizados desde tu exportación de productos de WooCommerce y mapearlos a espacios de nombres y claves de metacampos de Shopify durante la migración. En la vista de mapeo de k-sync, los atributos personalizados de WooCommerce se pueden mapear a los espacios de nombres y claves de metacampos de destino en Shopify antes de realizar el push.

Paso 6: Mostrar metacampos en tu tema de Shopify

Tras la importación, los metacampos deben representarse en la plantilla de la página de producto. El editor de temas de Shopify incluye un selector de metacampos para los bloques:

Panel de administración de Shopify → Tienda online → Temas → Personalizar → Página de producto
Añade un bloque de "Texto" → Fuente → selecciona un metacampo
O edita el Liquid del tema directamente: {{ product.metafields.nutrition.ingredients }}

Renderización en Liquid para diferentes tipos de metacampos

{%- comment -%} Texto de una línea {%- endcomment -%}
{{ product.metafields.specs.material.value }}

{%- comment -%} Texto multilínea (conserva los saltos de línea) {%- endcomment -%}
{{ product.metafields.nutrition.ingredients.value | newline_to_br }}

{%- comment -%} Texto enriquecido {%- endcomment -%}
{{ product.metafields.custom.description.value }}

{%- comment -%} URL (enlace) {%- endcomment -%}
{%- if product.metafields.docs.data_sheet_url.value -%}
  <a href="{{ product.metafields.docs.data_sheet_url.value }}">Descargar ficha técnica</a>
{%- endif -%}

{%- comment -%} Número {%- endcomment -%}
{{ product.metafields.specs.warranty_years.value }} años de garantía

Verificar la migración

Tras la importación, verifica una muestra de productos:

En el panel de administración de Shopify → Productos → selecciona un producto → desplázate hasta la sección "Metacampos" → verifica que todos los valores esperados están presentes
Visualiza la página del producto en vivo en tu tienda Shopify y verifica que los metacampos se representan correctamente
Comprueba aleatoriamente entre 5 y 10 productos de diferentes categorías
Comprueba que los metacampos más importantes (ingredientes, certificaciones, dimensiones) son correctos en los productos clave

La migración de campos personalizados es la parte más laboriosa de la migración de tiendas WooCommerce con muchos datos. Pero es fundamental — los clientes dependen de estos datos para tomar decisiones de compra, y las especificaciones de producto incompletas provocan mayores tasas de devolución y mayor volumen de soporte. Invertir tiempo en la migración de metacampos da sus frutos tras el lanzamiento.

Migrar campos personalizados de WooCommerce (ACF) a metacampos de Shopify (2026)