Attributes
Atributos
An attribute is a characteristic — colour, material, voltage — that you define once and then fill in on each product or SKU. Defining them once keeps the same word and the same choices across the whole catalogue.
Un atributo es una característica — color, material, voltaje — que definís una sola vez y después completás en cada producto o SKU. Definirlos una vez mantiene la misma palabra y las mismas opciones en todo el catálogo.
Define an attribute
Definir un atributo
- Go to Products → Attributes → Attribute Definitions and press New attribute.
- Fill in Identity: the Code (letters, numbers, hyphens and underscores, up to 100 characters; it cannot be changed afterwards), the Name people will see, and a Description.
- Choose the Data Type under Type & Scope: String, Number, Boolean, Date, Enum (single select), Multi-Enum (multi select), Rich Text or JSON.
- Choose the Scope: Product if it is filled in on the product family, SKU if it is filled in on each SKU, or Both. It starts on Both.
- Fill in Options if they apply: Default Value, Unit (for example cm or kg) and Sort Order.
- Tick the marks that apply: Required, Searchable, Filterable and Variant Axis. Tick Variant Axis on the attributes a product can vary by (see SKUs and variants).
- Add the Allowed Values when the type is one of the two enum types: type the Value, optionally a Label, and press Add. Repeat for each choice.
- Press Create.
- Entrá a Productos → Atributos → Definiciones de Atributos y tocá Nuevo atributo.
- Completá Identidad: el Código (letras, números, guiones y guiones bajos, hasta 100 caracteres; no se puede cambiar después), el Nombre que va a ver la gente, y una Descripción.
- Elegí el Tipo de dato en Tipo y alcance: Texto, Número, Booleano, Fecha, Enum (selección única), Multi-Enum (selección múltiple), Texto enriquecido o JSON.
- Elegí el Alcance: Producto si se completa en la familia de productos, SKU si se completa en cada SKU, o Ambos. Arranca en Ambos.
- Completá Opciones si corresponden: Valor por defecto, Unidad (por ejemplo cm o kg) y Orden.
- Tildá las marcas que correspondan: Obligatorio, Buscable, Filtrable y Eje de variante. Tildá Eje de variante en los atributos por los que puede variar un producto (mirá SKUs y variantes).
- Agregá los Valores permitidos cuando el tipo es uno de los dos tipos enum: escribí el Valor, si querés una Etiqueta, y tocá Agregar. Repetí por cada opción.
- Tocá Crear.
Maintain the list of attributes
Mantener la lista de atributos
- Edit. ⋮ → Edit changes the name, description, options and marks, and for enum types lets you add or remove allowed values. Removing an allowed value does not change the products that already use it.
- Deactivate and activate. The control in the Status column turns an attribute off and on.
- Deprecate. ⋮ → Deprecate retires an attribute for good: products keep the values they have, but the attribute is no longer offered when adding attributes. It cannot be undone.
- Filter. The chips for Type, Scope and Status and the box Filter by name, code, or description… narrow the rows of the page you are on. If the attribute you look for is not there, go to the next page.
- Editar. ⋮ → Editar cambia el nombre, la descripción, las opciones y las marcas, y en los tipos enum permite agregar o quitar valores permitidos. Quitar un valor permitido no cambia los productos que ya lo usan.
- Desactivar y activar. El control de la columna Estado apaga y prende un atributo.
- Marcar obsoleto. ⋮ → Marcar obsoleto retira un atributo definitivamente: los productos conservan los valores que tienen, pero el atributo deja de ofrecerse al agregar atributos. No se puede deshacer.
- Filtrar. Los chips de Tipo, Alcance y Estado y el cuadro Filtrar por nombre, código o descripción… acotan las filas de la página en la que estás. Si el atributo que buscás no está, pasá a la página siguiente.
Fill in the attributes of a product or SKU
Completar los atributos de un producto o SKU
Open the product family or the SKU and go to its Attributes tab. The values are in blocks: Required by category (what its category asks for and is still empty), Direct Values (what is set on this item) and, on a SKU, Inherited Values (what it takes from its product family).
Abrí la familia de productos o el SKU y andá a su pestaña Atributos. Los valores están en bloques: Requerido por categoría (lo que pide su categoría y sigue vacío), Valores directos (lo que está cargado en este elemento) y, en un SKU, Valores heredados (lo que toma de su familia de productos).
- Press Add Attribute. The Add an attribute window opens with suggestions; the ones its category asks for are marked Required or Recommended.
- Pick an attribute from the list, or type to search it.
- Type or choose the Value and press Save. You see Value saved.
- To change a value later, press the pencil on its row (or double-click the value), set the new value and confirm with the tick. Do this for as many rows as you need.
- Press Save Changes. Nothing you edited with the pencil is stored until you do. Discard drops all the pending edits.
- Tocá Agregar atributo. Se abre la ventana Agregar un atributo con sugerencias; los que pide su categoría llevan la marca Requerido o Recomendado.
- Elegí un atributo de la lista, o escribí para buscarlo.
- Escribí o elegí el Valor y tocá Guardar. Ves Valor guardado.
- Para cambiar un valor después, tocá el lápiz de su fila (o hacé doble clic en el valor), poné el valor nuevo y confirmá con el tilde. Hacelo en todas las filas que necesites.
- Tocá Guardar cambios. Nada de lo que editaste con el lápiz queda guardado hasta que lo hacés. Descartar tira todas las ediciones pendientes.
- To remove a value, press the bin on its row and confirm in Remove Attribute.
- To give a SKU its own value where it inherits one, press the pencil on the inherited row, change it and save. The row moves to Direct Values. If you later remove that value, the inherited one shows again.
- If the attribute does not exist, type its name in the search box and press Create new attribute. Give it a Type, its Choices if it has them, and its first value, then press Create. New attributes made this way go to a review list (see below).
- Para quitar un valor, tocá el tacho de su fila y confirmá en Quitar atributo.
- Para darle a un SKU un valor propio donde hereda uno, tocá el lápiz de la fila heredada, cambialo y guardá. La fila pasa a Valores directos. Si después quitás ese valor, vuelve a verse el heredado.
- Si el atributo no existe, escribí su nombre en el buscador y tocá Crear nuevo atributo. Dale un Tipo, sus Opciones si las tiene, y su primer valor, y tocá Crear. Los atributos nuevos creados así van a una lista de revisión (ver más abajo).
Group attributes
Agrupar atributos
Products → Attributes → Attribute Groups lets you bundle attributes that go together, such as Dimensions or Care. Press New Group, type a Code and a Name and press Create. Then open the group, go to Members, press Add Attribute, tick the attributes and press Add Selected. A group can be deactivated from its ⋮ menu; it cannot be deleted. Use Edit on the group to set its Description and Sort Order.
Productos → Atributos → Grupos de Atributos permite juntar los atributos que van juntos, como Dimensiones o Cuidado. Tocá Nuevo grupo, escribí un Código y un Nombre y tocá Crear. Después abrí el grupo, andá a Miembros, tocá Agregar atributo, tildá los atributos y tocá Agregar seleccionados. Un grupo se puede desactivar desde su menú ⋮; no se puede eliminar. Usá Editar en el grupo para cargarle la Descripción y el Orden.
Review attributes created on the fly
Revisar los atributos creados sobre la marcha
Attributes created from a product, a SKU or a category, instead of from Attribute Definitions, are listed in the Needs Review card of Products → Attributes so that whoever looks after the catalogue can check them. The ⋮ menu of each one offers:
Los atributos creados desde un producto, un SKU o una categoría, en vez de desde Definiciones de Atributos, quedan listados en la tarjeta Pendiente de revisión de Productos → Atributos para que quien cuida el catálogo los controle. El menú ⋮ de cada uno ofrece:
| Option | What it does |
|---|---|
| Bless (mark curated) | Accepts the attribute as it is and takes it off the list. |
| Open definition | Opens the attribute to look at it or edit it. |
| Merge into… | Joins it with another attribute of the same type that means the same. Search the attribute to keep; the window tells you how many values will move and how many will be discarded because the attribute you keep already has one. Press Merge. The merged attribute is deprecated. |
| Deprecate | Retires the attribute. |
| Opción | Qué hace |
|---|---|
| Aprobar (marcar curado) | Acepta el atributo como está y lo saca de la lista. |
| Abrir definición | Abre el atributo para mirarlo o editarlo. |
| Combinar con… | Lo une con otro atributo del mismo tipo que significa lo mismo. Buscá el atributo a conservar; la ventana te dice cuántos valores se van a mover y cuántos se descartan porque el atributo que conservás ya tiene uno. Tocá Combinar. El atributo combinado queda obsoleto. |
| Descontinuar | Retira el atributo. |
Common issues
Problemas habituales
- "This code is already in use"
- Another attribute has that code. Before choosing another code, check whether the attribute you need already exists.
- "Only letters, numbers, hyphens and underscores"
- The code does not accept spaces, accents or other symbols.
- "This option already exists"
- That allowed value is already on the list.
- "Attribute '…' has scope SKU and cannot be set on FAMILY" (or the reverse)
- The attribute was defined for the other level. Fill it in on the SKU (or on the product family), or define an attribute with scope Both.
- "Similar attributes already exist."
- The name you typed looks like an attribute that exists. Click it to reuse it, or press Create anyway if it really is something else.
- "Enter a value before saving" / "Add at least one choice"
- A value is mandatory when you add an attribute, and a choice attribute needs at least one choice.
- "Failed to save attributes"
- The values were not stored. If the notice names an attribute, correct that value; otherwise press Save Changes again.
- A deprecated attribute still shows on a product
- Deprecating does not erase the values already loaded. Remove them from the Attributes tab of the product if you no longer want them.
- An attribute I deprecated is still in Needs Review
- Only Bless (mark curated) takes an attribute off that list.
- «Este código ya está en uso»
- Otro atributo tiene ese código. Antes de elegir otro código, fijate si el atributo que necesitás ya existe.
- «Solo letras, números, guiones y guiones bajos»
- El código no acepta espacios, acentos ni otros símbolos.
- «Esta opción ya existe»
- Ese valor permitido ya está en la lista.
- «Attribute '…' has scope SKU and cannot be set on FAMILY» (o al revés)
- El atributo se definió para el otro nivel. Completalo en el SKU (o en la familia de productos), o definí un atributo con alcance Ambos.
- «Ya existen atributos similares.»
- El nombre que escribiste se parece a un atributo que existe. Hacé clic en él para reutilizarlo, o tocá Crear de todos modos si de verdad es otra cosa.
- «Ingresa un valor antes de guardar» / «Agrega al menos una opción»
- El valor es obligatorio cuando agregás un atributo, y un atributo con opciones necesita al menos una.
- «No se pudieron guardar los atributos»
- Los valores no se guardaron. Si el aviso nombra un atributo, corregí ese valor; si no, tocá Guardar cambios de nuevo.
- Un atributo obsoleto sigue apareciendo en un producto
- Marcarlo obsoleto no borra los valores ya cargados. Quitalos desde la pestaña Atributos del producto si ya no los querés.
- Un atributo que descontinué sigue en Pendiente de revisión
- Solo Aprobar (marcar curado) saca un atributo de esa lista.