Skip to main content

Custom fields

How custom fields work: modules, creating a group (where the level is set), adding fields, calculated fields, and the field table.

Custom fields let you add your own needed fields to products, components, and suppliers, so you can record and show information specific to how your brand works. They appear as columns and properties on the items they're attached to.

Choosing the module

The page has three tabs at the top — Product, Supplier, and Component. Select the tab you want to add fields to or configure before making any changes. The groups and fields shown below belong to the currently selected tab.

The field table

Each group lists its fields in a table showing their column position, starting state, type, properties, entities, whether they're calculated, and whether their value copies on duplication. On every tab you can reorder fields within a group by dragging them, move a field to another group by dragging it across and click a field to open it for full editing.

The Custom fields page — groups, each listing its fields in a table with ID, name, column, starting state, type, properties, entities and calculated, plus Add field

Right-click a field for quick actions — Edit, Starting state, Duplicate, and Delete. On the Product tab the right-click menu adds one more item, Entities, which sets the wanted level — product, article, and/or SKU for that field, even if the level is set to something else on the group.

The Supplier and Component tabs have no level, so this option doesn't appear there.

The right-click menu on a Product field showing Edit, Starting state, Entities, Duplicate, and Delete

Creating a group

Fields live inside groups, so you create a group first with Add group, which opens a popper. On every tab the popper has the same three basics: a title, an icon (the group shows as that icon in the interface), and a Non-user group toggle. Turning on Non-user group makes the group's fields non-editable by hand — useful for fields that are filled in through the API, so the information is visible but no one can change it manually.

On the Product tab the popper adds three more options: Default entities, which sets the level the group's fields sit at — Product, Article, or SKU — and which every field in the group then inherits; Seasonality, to make the group's values season-specific; and Visible for hierarchy nodes, to limit the group to particular nodes (leaving the list empty keeps it visible on all nodes). Visibility is display-only — fields hidden this way are still included in exports. These three don't appear on the Supplier or Component tabs.

The Create group popper on the Product tab showing the title, icon, seasonality and non-user toggles, and default entities

Adding fields

Adding fields works the same on every tab. Inside a group, click Add field to open the field popper, which has:

  • Name — what the field is called.

  • Full name — an alternate name used in imports and exports.

  • Key — the field's identifier for the API.

  • Type — what the field holds (see the types below).

  • Copy product/article — when this is on and you copy a product, the value in the field is copied into the new product.

  • Calculated field — when on, the field's value is worked out by a template instead of being typed in (see below).

Save, and the field is created inside the group, taking the group's level.

The Add field popper with name, full name, key, type, copy and calculated-field controls

Field types

The type you choose changes what else you fill in:

  • Text — free text; you can make it multiline and set placeholder text.

  • Money — a monetary value; choose which currencies are allowed.

  • Amount/Quantity — a number tied to a unit; choose which units are allowed.

  • Select — one value from a list you build, each option with a value and a code; you can make it searchable, allow adding options on the fly, and set the sort order.

  • Multi-select — the same as Select, but more than one value can be chosen and shown as checkboxes.

  • Files — file uploads.

Calculated fields

Turning on Calculated field in the popper means the value is worked out by a template rather than entered. The template language is Liquid, and the editor lists the variables you can insert — the field's own key, variables for the different field types (money, number, select, file, and price fields), and seasonal exchange-rate variables.

💡 Good to know. Liquid is a widely used templating language, so you can look up its syntax online or ask the Resourced support team to help build a formula.

The Calculated values button

Separate from the per-field toggle, the Calculated values button at the top of the page is a maintenance action: it runs a dry run that counts linked values which no longer match their calculated result, and can mark mismatched overridable values as unlinked so they stop being recalculated.

Did this answer your question?