Las tiendas WooCommerce suelen extender los datos de producto con campos personalizados — a través de Advanced Custom Fields (ACF), atributos de producto de WooCommerce, WooCommerce Product Add-Ons o meta de post personalizado directo. El equivalente en Shopify son los metafields: datos estructurados en formato clave-valor vinculados a productos, variantes, clientes, pedidos, colecciones y otros objetos. Comprender los metafields es esencial para una migración exitosa, ya que los atributos de producto almacenados en campos personalizados de WooCommerce necesitan ubicarse en algún lugar de Shopify.

Qué son los metafields

Un metafield es un dato estructurado vinculado a un recurso de Shopify (producto, variante, colección, cliente, etc.). Tiene tres componentes:

Namespace: Agrupa metafields relacionados (p. ej. custom, product, seo). Usa un namespace descriptivo para tu proyecto (p. ej. clothing, electronics, specs).
Key: El nombre del campo dentro del namespace (p. ej. material, warranty_years, compatible_models).
Value: El dato almacenado, con tipo según el tipo de metafield.

Ejemplo: product.metafields.clothing.material = "100% algodón orgánico"

Tipos de metafield

Tipo	Uso	Ejemplo
Texto de una línea	Valores de texto cortos	Material, color, marca
Texto multilínea	Texto más largo, notas formateadas	Instrucciones de cuidado, especificaciones técnicas
Entero	Números enteros	Años de garantía, edad mínima, cantidad
Decimal	Números decimales	Peso, dimensiones, % de alcohol, mg de THC
Verdadero/Falso	Indicadores booleanos	Apto para lavavajillas, vegano, certificado orgánico
Fecha	Valores de fecha	Fecha de producción, fecha de caducidad
URL	Enlace	URL de ficha de datos de seguridad, certificado de laboratorio
JSON	Datos estructurados	Listas de compatibilidad, tablas de especificaciones
Archivo	Archivos adjuntos	Manual de instrucciones en PDF
Color	Valor del selector de color	Hexadecimal del color principal
Valoración	Valoración en estrellas	Valoración de calidad del producto
Medida	Valor + unidad	Peso en kg, altura en cm
Lista de [tipo]	Múltiples valores del mismo tipo	Lista de modelos compatibles (lista de texto)
Referencia a metaobjeto	Enlace a un objeto estructurado personalizado	Vinculado a un metaobjeto "Artista"

Definiciones de metafield frente a namespaces personalizados

Shopify admite dos enfoques para los metafields:

Metafields definidos: Configurados en Admin de Shopify → Configuración → Datos personalizados. Tienen un tipo específico, están validados, aparecen en la interfaz de edición del producto y pueden mostrarse en los temas mediante bloques de metafield. Recomendado para todos los campos que quieras que tu equipo pueda editar.
Metafields no estructurados: Configurados via API sin definición previa. Útiles para la importación de datos programática, pero no editables en el panel de administración sin una definición.

Durante la migración con k-sync, los metafields se envían a Shopify a través de la API. Crea las definiciones de metafield en el Admin de Shopify tras la migración para que tu equipo pueda editarlos sin necesidad de acceso a la API.

Reemplazo de campos personalizados de WooCommerce

Enfoque en WooCommerce	Equivalente en metafield de Shopify
Campo ACF en tipo de post de producto	Metafield definido (namespace de producto)
Atributo de producto WooCommerce (global)	Opciones de producto de Shopify (para variantes) o metafields (para datos de especificaciones)
Atributo de producto WooCommerce (personalizado)	Opciones de producto o metafields de Shopify
Campo personalizado de WooCommerce (meta box)	Metafield definido
Contenido de pestaña de producto (WooCommerce Tab Manager)	Metafield (texto multilínea) + sección del tema
Documentos/archivos PDF adjuntos al producto	Metafield tipo: archivo

Mostrar metafields en tu tema

Los temas Online Store 2.0 de Shopify (Dawn y todos los temas modernos) admiten bloques de metafield en el editor del tema. Para mostrar un metafield en una página de producto:

Crea una definición de metafield en Admin → Configuración → Datos personalizados → Productos
En el editor del tema de la tienda online, navega a una plantilla de página de producto
Añade un bloque de "Texto" o "Metafield" a la sección del producto
Configura el bloque para mostrar el metafield específico

Para visualizaciones complejas de metafields (tablas, visibilidad condicional), se requiere personalización de Liquid en el tema o una app de visualización de metafields (Metafields Guru, Custom Fields).

Edición masiva de metafields tras la migración

Después de una migración con k-sync, algunos metafields estarán poblados por la importación (datos que existían en WooCommerce) y otros necesitarán completarse manualmente. Para la edición masiva:

Admin de Shopify → Productos → Todos los productos → Exportar: Las exportaciones incluyen columnas de metafield para los metafields definidos. Edita en una hoja de cálculo y vuelve a importar.
App Metafields Guru: Editor masivo estilo hoja de cálculo para metafields en el panel de administración de Shopify.
API Admin de Shopify: Actualización masiva programática de metafields mediante la mutación GraphQL metafieldsSet.

Estrategia de metafields para la migración

Un enfoque práctico para los metafields durante la migración:

Audita los campos personalizados de WooCommerce: Lista todos los campos personalizados en uso en todos los tipos de producto. Anota qué campos se muestran públicamente y cuáles son solo internos.
Categoriza cada campo: ¿Es una opción de variante (crea SKUs separados para compra)? ¿Una especificación (solo visualización)? ¿Un campo de seguimiento interno? ¿Un campo de contenido (texto largo)?
Diseña los namespaces: Usa un namespace por categoría de producto (p. ej. electronics, clothing) o uno para todos los datos personalizados (custom).
Crea definiciones antes de la importación: Pre-crea las definiciones de metafield en Shopify para que los valores importados via API sean inmediatamente tipados y editables.
Configura la visualización en el tema: Configura los bloques de metafield de la plantilla de página de producto para los campos que los clientes necesitan ver.

Lista de comprobación de metafields post-migración

Campos personalizados de WooCommerce auditados y mapeados a definiciones de metafield de Shopify
Definiciones de metafield creadas en Admin de Shopify → Configuración → Datos personalizados
Bloques de metafield del tema configurados para datos de especificaciones visibles públicamente
Herramienta de edición masiva identificada para el enriquecimiento de metafields post-migración
Metafields solo internos configurados con namespace correcto (no expuestos en el tema)
Comprobación puntual en 20 productos: verificar que los valores de metafield se migraron correctamente

Metafields de Shopify: guía práctica para tiendas que migran desde WooCommerce (2026)