Custom data

Open Settings › Custom data. It holds your own fields on Products and on Collections, such as care instructions, ingredients or a banner colour.

Where fields can go

Fields can go on Products, Collections, Pages, Blog posts, Your store, Customers and Orders. Themes can show those on products, collections, pages, blog posts and the store. Fields on Customers and Orders are for your team alone, so they can hold what shoppers must not read. You fill them in on the customer’s or order’s page, or on the page or post, and they save with the bar at the top. For Your store, the values are under Settings › General.

Add a field

Under Products or Collections, give the New field a name and choose its Kind: Text (one line), Text (several lines), Rich text, Number, Yes or no, Link, Colour, Date, Date and time, Image, Video, Product, Collection, Choice, Amount of money or Rating. A Choice asks for its choices, one on each line. Several values lets one field hold a list, such as all the materials of a product: type one on each line, or tick them for a choice. Add field keeps it at once. Each kind can hold up to 50 fields.

Under the name, the page shows how your theme reads the field, such as product.metafields.custom.care_instructions. That key comes from the first name and stays when you rename the field. A name may be in any alphabet and start with any letter, such as Грижа 🌱: Cyrillic becomes Latin letters in the key (grizha), a name in another alphabet gets field, and a key another field has gets a number (grizha_2). Content types and their fields make their keys the same way.

You can also add a field from a product’s or collection’s own page: in its Custom data card choose New field, give it a name and a kind, then Add field. Owners and admins can do this.

Rename or remove a field

Tap a field’s name to rename it (the pencil beside it shows it can change), type, and press Enter; Escape keeps the old name. The trash button removes a field after you confirm, and its value on every product or collection goes with it.

Fill in a field

Open a product or a collection and find Custom data. Fill in the fields, then Apply in the bar at the top. A number, link, colour or date is checked as you save; an empty field is left out.

An Image or Video field has two buttons. Upload takes a file straight from your device and keeps it in Content › Files. Choose opens the files you already have. Neither takes an address: every picture is kept with your store. Images can be up to 5 MB; videos can be MP4 or WebM, up to 20 MB.

Use a value on other products

When you save a value, Storeloom asks where else it should go: Just this product, All products in each collection the product is in, or All products. A collection asks the same with Just this collection or All collections. Each choice shows how many it reaches. If some of them already have their own value, it says so before you Apply, because that value is replaced; Time travel in Settings can undo it. The question does not appear when there is nothing else to apply it to, and closing it keeps the value on this one alone. At most 5,000 can change at once.

Use a field elsewhere

Under Products, Add filter has Custom field: choose the field and what it should or should not be. In an automatic collection, a condition can read a custom field too, such as Material is Wool, and products join or leave as their value changes.

Show it in your store

Your theme shows a product’s fields as product.metafields.custom.<key> and a collection’s as collection.metafields.custom.<key>, in the code editor or by the assistant. A product or collection field holds its id.

In the theme editor, Fill in from your store offers your fields too: text fields beside a text setting, image fields beside an image setting and video fields beside a video setting. The store then shows each product’s or collection’s own value; a page without one shows what the block shows when empty.

Without code, the default theme shows a product field on product cards: in the theme editor, Theme settings › Product cards › Label from a product field puts its value on the card’s picture (a short text field, such as “label” holding “New”), and Detail line from a product field shows it as one line under the name (such as “material” holding “Stoneware”). Fields hold one value in every language.

Who can change it

Owners and admins add, rename and remove fields; whoever can edit products or collections fills them in.