Gallery Platform Help

Custom fields & work statuses

Add your own fields to records, and name artwork statuses the way your gallery does.

Two settings let you bend the data model to how your gallery actually works.

Custom fields

Add fields the platform doesn't ship. Pick which kind of record you're adding to — artworks, contacts, or shows — and each keeps its own set, up to 50 fields at a time.

Collections don't take custom fields for now. If your gallery added some before, they still show on the Custom fields page, read-only.

Five field types: text, number, date, select (a fixed list of options you supply), and yes/no.

You can put fields in a group by typing a group name, which keeps a long list organised on the record. You can also add a short description to say what the field is for.

Keys

Every field has a key: a short name like frame_condition, made of lowercase letters, numbers, and underscores. The key is how integrations and the API refer to the field.

You can type a key when you create the field, or leave it blank and one is made from the name. Once the field exists, its key never changes, even when you rename the field. That way, nothing that uses the key breaks.

Two fields on the same kind of record can't share a key. If you pick one that's taken, you're asked for another.

Where the values show up

A custom field appears as a section on the record's own page — the artwork's overview tab, the contact, the show. Values save as you type.

Custom fields are not inventory list columns, and they don't appear in CSV exports or filters. They're also available over the API, so an integration can read and write them by key.

Two things to decide before you create a field

A field's type is fixed once created, and so are its key and a select field's options. If you need a different type, create a new field and archive the old one.

Renaming is safe — click the name, type, click away. The key stays the same.

Archiving, and why deleting is only for unused fields

Archive a field you've stopped using. It disappears from every record, and nobody can fill it in, but the values already saved are kept. When a kind of record has archived fields, a Show archived button appears: select it to see them again, and Unarchive one to bring it back with its values. An unarchived field counts towards the 50 again.

Delete is only offered for a field no record has filled in. It asks you to type the field's name to confirm, and there's no undo. A field that holds values can't be deleted, so its values can never be lost by accident.

Editors can add, rename, describe, archive, and delete fields. Everyone can read them.

Work statuses

Every work carries a status. The platform has its own built-in vocabulary — available, reserved, on hold, under offer, on approval, on loan, sold, not for sale, returned, damaged, destroyed — but galleries rarely use exactly those words.

Work statuses lets you use yours. Create a status with your own label, and say which built-in status it counts as.

That mapping is the part that matters. Call something "With the framer" and map it to on loan, and the work reads as "With the framer" everywhere your team looks, while reports, availability, and the public surfaces still understand it's not for sale right now. You get your language without the platform losing the plot.

On the work itself there's a single status control, listing your labels. Pick one and both the label and its underlying meaning are set together.

Archiving, and why deleting usually fails

Archive a status you've stopped using. It disappears from the picker for new works but stays on the works that already have it, and can be restored.

Delete only works if no work uses the status. If any does, the platform refuses and tells you to archive it instead — so a status can never be removed out from under your inventory.

Renaming

There's no rename here. To change a status's wording, add the new one, move the works across, and archive the old one.

This page is editor-only — it's blank for everyone else.

On this page