¿Qué son los custom fields de BigCommerce?

Al editar un producto en BigCommerce, más abajo del precio y de las imágenes hay una sección llamada Custom fields: una lista de pares de nombre y valor que rellenas a mano. «Tejido: lino lavado». «Corte: recto». No son opciones de compra ni variantes de producto, porque el cliente no elige nada con ellos, y tampoco son los metafields de Shopify, aunque se comparen a menudo. Son la ficha técnica que la plataforma deja escribir sin tocar el tema. Te importa porque ahí suelen acabar los atributos de producto que buscan tanto tus clientes como los buscadores, y porque que un dato esté en el producto no significa que esté en la página.

Cómo funciona

El centro de ayuda de BigCommerce los presenta como información adicional del producto que aparece en su ficha, con ejemplos como el ISBN de un libro, la fecha de estreno de una película o la añada de un vino. Se muestran como pares de nombre y valor, separados de la descripción, y aparecen solos en los detalles del producto si están definidos. Dónde, exactamente, depende del tema: algunos los ponen en su propia pestaña.⁠^{[1]BigCommerce, centro de ayuda. Custom Fields}

Se crean de tres maneras: en el panel, desde la ficha del producto, en la sección Custom fields; en bloque, importando un CSV; o por API.⁠^{[1]BigCommerce, centro de ayuda. Custom Fields} La API de catálogo los crea con una petición POST a /v3/catalog/products/{product_id}/custom-fields, y sus reglas son estas:⁠^{[2]BigCommerce API Reference. Create Product Custom Field}

• Dos campos obligatorios, name y value. Los dos se muestran en la tienda, en los pedidos y en otros sitios, según la propia referencia.
• Cada par nombre-valor tiene que ser único dentro del producto.
• Como máximo, 200 custom fields por producto y 250 caracteres por campo.

El centro de ayuda habla de 255 caracteres por campo.⁠^{[1]BigCommerce, centro de ayuda. Custom Fields} El curso de la API de catálogo de BigCommerce da 250 como límite de los valores que alimentan la búsqueda por filtros,⁠^{[3]BigCommerce Developer Learning. Images, Videos, and Custom Fields} así que 250 es la cifra segura.

El valor admite HTML, CSS y JavaScript, para dar formato o incrustar imágenes y vídeos; el nombre no. BigCommerce avisa de una consecuencia: quien puede editar custom fields puede añadir scripts al valor, aunque no tenga el permiso de gestionar scripts.⁠^{[1]BigCommerce, centro de ayuda. Custom Fields}

Tres usos más allá de la ficha, cada uno con su condición:⁠^{[1]BigCommerce, centro de ayuda. Custom Fields}

• Filtros. En los planes Scale o superiores con el filtrado de productos activo, cada custom field puede servir de filtro en las páginas de categoría, de marca y de resultados de búsqueda. El filtro se crea solo, pero no aparece hasta que lo marcas como visible. Si el nombre coincide con el de una opción de producto, no sale como filtro; si coincide con un filtro de serie, como el de marca, el de precio o el de categoría, BigCommerce da el error «Failed to save filters. Duplicate usage of facet».
• Canales. Google y Meta piden datos que no siempre tienen un campo propio en BigCommerce, y según el conector que uses puedes dárselos como custom fields. Con Feedonomics, algunos, como la edad y el género, se asignan solos.
• Idiomas. En tiendas con varios escaparates, la API de administración en GraphQL permite traducir un custom field para el idioma de cada canal. Solo está disponible para tiendas Enterprise y entornos de pruebas de partners.⁠^{[4]BigCommerce Dev Center. Product custom fields (International Enhancements for Multi-Storefront)}

La propia BigCommerce usa este hueco en su herramienta de enriquecimiento de catálogo, Catalog Enrichment: de los siete campos que genera, cuatro sobrescriben datos de serie (nombre, descripción, meta description y título SEO) y tres se añaden como custom fields, pensados para los motores de respuesta, y su documentación dice que si se muestran o no depende del tema.⁠^{[5]BigCommerce Dev Center. Fields in an enrichment}

En una tienda

Ejemplo ficticio. Calella, una tienda inventada en BigCommerce, añade el tejido a su camisa de lino (el producto 112) con la API:

{
  "name": "Tejido",
  "value": "lino lavado"
}

Lo que pase después depende del tema. En Cornerstone, el tema por defecto de BigCommerce, la plantilla que pinta los custom fields en su versión 6.22.0 es esta:⁠^{[6]BigCommerce en GitHub. Cornerstone, the default Stencil theme (release 6.22.0)}

{{#each product.custom_fields}}
  <dt class="productView-info-name">{{name}}:</dt>
  <dd class="productView-info-value">{{{value}}}</dd>
{{/each}}

Recorre la lista del producto y escribe cada par como un término y su definición. Las tres llaves de {{{value}}} dejan pasar el valor sin escapar, que es lo que permite el HTML del que habla el centro de ayuda. Cornerstone llama a esa plantilla desde la ficha, en la lista de detalles, salvo que el ajuste del tema show_custom_fields_tabs esté activo: entonces los pinta en una pestaña con la descripción.⁠^{[6]BigCommerce en GitHub. Cornerstone, the default Stencil theme (release 6.22.0)} En el HTML de la ficha 112 aparecería <dt class="productView-info-name">Tejido:</dt> seguido de su valor.

Y una ausencia que conviene conocer: el bloque JSON-LD de Product de Cornerstone 6.22.0 no incluye ningún custom field. Lleva el nombre, el SKU, el MPN, el GTIN, la marca, la descripción, la imagen, la oferta y, si la tienda las muestra, las valoraciones, pero el tejido no.⁠^{[6]BigCommerce en GitHub. Cornerstone, the default Stencil theme (release 6.22.0)} El dato está en la página para quien la lee, y no está en sus datos estructurados.

Cómo comprobarlo

1. Abre el producto en el panel y mira la sección de custom fields: cuántos hay y cómo se llaman. Si se acercan a 200, o un valor pasa de 250 caracteres, hay que repartir.⁠^{[2]BigCommerce API Reference. Create Product Custom Field}
2. Abre la ficha publicada y su código fuente (Ctrl+U en Chrome) y busca el valor exacto de uno de ellos. Si no aparece, el tema no lo está pintando.
3. Busca application/ld+json en el mismo código y comprueba si el dato está en el marcado. En Cornerstone, de serie, no lo estará.⁠^{[6]BigCommerce en GitHub. Cornerstone, the default Stencil theme (release 6.22.0)}
4. Revisa los nombres antes de usarlos como filtros: ninguno debería coincidir con una opción del producto ni con los filtros de serie de marca, precio o categoría.⁠^{[1]BigCommerce, centro de ayuda. Custom Fields}
5. Lee los valores que llevan código. Cualquiera con permiso para editarlos puede haber añadido un script.⁠^{[1]BigCommerce, centro de ayuda. Custom Fields}

Concepto cercano: metafields

BigCommerce también tiene metafields, y la diferencia es de público. Un metafield es un par de clave y valor definido por un desarrollador, que se puede asociar a productos, variantes, categorías, marcas, pedidos, clientes y otros objetos, y cada uno lleva un permiso: privado para la aplicación que lo creó, visible o editable por otras aplicaciones, o además accesible desde el escaparate. Se gestionan por API y, para mostrarlos en la tienda, se leen con la API de escaparate en GraphQL.⁠^{[8]BigCommerce Dev Center. Metafields} Un custom field, en cambio, nace para verse en la ficha.⁠^{[2]BigCommerce API Reference. Create Product Custom Field} Lo que el cliente debe leer va en un custom field; lo que una aplicación necesita guardar, en un metafield. La entrada de metafields explica cómo funcionan en Shopify.

Para seguir, la entrada de Stencil explica el motor de temas que decide qué se pinta, y la ruta de publicación por plataforma ordena el resto de términos.