# Custom fields de BigCommerce: qué son y dónde salen
> Qué son los custom fields de BigCommerce, sus límites (200 por producto), cómo los pinta un tema Stencil y en qué se diferencian de los metafields.
URL: https://clione.ai/es/glosario/custom-fields-bigcommerce/
Lang: es
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](/es/glosario/variantes-de-producto/), porque el cliente no elige nada con ellos, y tampoco son los [metafields](/es/glosario/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](/es/glosario/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.[^bc-help-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.[^bc-help-custom-fields] La [API de catálogo](/es/glosario/api-de-catalogo/) los crea con una petición `POST` a `/v3/catalog/products/{product_id}/custom-fields`, y sus reglas son estas:[^bc-api-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.[^bc-help-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,[^bc-learn-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.[^bc-help-custom-fields]
Tres usos más allá de la ficha, cada uno con su condición:[^bc-help-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.[^bc-msf-custom-fields]
La propia BigCommerce usa este hueco en su herramienta de [enriquecimiento de catálogo](/es/glosario/enriquecimiento-de-catalogo/), Catalog Enrichment: de los siete campos que genera, cuatro sobrescriben datos de serie (nombre, descripción, [_meta description_](/es/glosario/meta-description/) y [título SEO](/es/glosario/meta-title/)) 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.[^bc-enrichment-fields]
## 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:
```json
{
"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:[^cornerstone-repo]
```handlebars
{{#each product.custom_fields}}
{{name}}:
{{{value}}}
{{/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.[^cornerstone-repo] En el HTML de la ficha 112 aparecería `Tejido:` seguido de su valor.
Y una ausencia que conviene conocer: **el bloque [JSON-LD](/es/glosario/json-ld/) de [Product](/es/glosario/schema-product/) de Cornerstone 6.22.0 no incluye ningún custom field**. Lleva el nombre, el [SKU](/es/glosario/sku/), el [MPN](/es/glosario/mpn/), el [GTIN](/es/glosario/gtin/), la marca, la descripción, la imagen, la oferta y, si la tienda las muestra, las valoraciones, pero el tejido no.[^cornerstone-repo] El dato está en la página para quien la lee, y no está en sus [datos estructurados](/es/glosario/datos-estructurados/).
Creer que un custom field está en la página porque está en el producto. Que salga o no lo decide el tema: BigCommerce dice que su posición depende del tema,[^bc-help-custom-fields] y su propio curso de [Stencil](/es/glosario/stencil/) enseña a ocultar uno por su nombre con una condición en la plantilla de la ficha.[^bc-lab-custom-field] Un tema modificado, o uno de otro proveedor, puede no pintarlos todos, y un dato que no está en el HTML no se puede leer en la página, ni por un cliente ni por un [rastreador](/es/glosario/rastreador/).
## 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.[^bc-api-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á.[^cornerstone-repo]
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.[^bc-help-custom-fields]
5. **Lee los valores que llevan código.** Cualquiera con permiso para editarlos puede haber añadido un script.[^bc-help-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.[^bc-metafields] Un custom field, en cambio, nace para verse en la ficha.[^bc-api-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](/es/glosario/metafields/) explica cómo funcionan en Shopify.
Para seguir, la entrada de [Stencil](/es/glosario/stencil/) explica el motor de temas que decide qué se pinta, y la [ruta de publicación por plataforma](/es/aprender/publicacion-por-plataforma/) ordena el resto de términos.