# Add your own properties

Give a kind of Library item fields of your own, such as who made a creative, fill them in on your items, find items by them, and credit them in the Lab.

![Properties on Assets: Assets · your own fields on these types, the type Image with its two properties, Creator tier, a Choice marked atom, and Script version, a Number, the Property button, and what properties do](https://docs.omnymous.com/media/library/properties/panel.606fe73b.avif)

Omnymous reads the pieces of your ads it knows about: avatars, angles, hooks, offers. Your team may track others, such as who produced a creative, which script it was cut from, or an internal test code. A property adds that field to one kind of item. Fill it in on your items, search by it, and, when it describes something an ad carries, let the Attribution Lab credit it like any other piece.

## Before you start

- You are an owner, an admin or a member of the workspace. A viewer can read the properties but not change them.
- Know the values the field takes: a short list of choices, a number, yes or no, or free text.
- About five minutes.

## Add a property

1. **Open Properties**

   On **Variables**, **Assets** or **Knowledge**, press **Properties**, the sliders in the toolbar. The panel opens on the right for that page's kinds of item.

2. **Choose the kind of item**

   At the top of the panel, choose the type the property belongs to, such as **Image**. The line under it says what its properties can become: on a creative, **Groupable properties here are attribution atoms at the attention stage.**

3. **Press Property**

   **Property**, under the list, adds a card and opens it.

4. **Name it**

   Type its **Label**, such as _Shot style_. The **Key** follows as you type, _shotStyle_: it is how the property is stored and searched, and it cannot change once saved.

5. **Choose its kind**

   Under **Kind**, choose **Choice**, **Number**, **Yes / No** or **Text**. For a choice, type its **Values** separated by commas, such as _studio, lifestyle, ugc_.

   ![A new property card: Label Shot style, Key shotStyle, Kind Choice, Values studio, lifestyle, ugc, Required unticked and Attribution atom ticked](https://docs.omnymous.com/media/library/properties/new.3332be3d.avif)

6. **Decide what it is for**

   Tick **Required** if every item of this kind must have a value. Leave **Attribution atom** ticked for the Lab to credit each value on its own; untick it for a field you only want to read and search.

7. **Save**

   Press **Save** at the foot of the panel. A message confirms it, such as **Image: 3 properties saved**.

## Fill it in on an item

Open an item of that kind, press **Edit**, then the **Properties** tab: your property is there, under **Your properties**, after the type's own fields. Choose or type its value and press **Save changes**. The item's panel then lists it under **Properties**.

![The Properties section of a creative's panel: Creator tier, Freelance, and Script version, 3](https://docs.omnymous.com/media/library/properties/value.bc3a03a3.avif)

An item other items were written on is locked for editing. See [Edit an item](https://docs.omnymous.com/library/inspector#edit-an-item).

## Find items by it

Type the key and a value in the page's search, such as `creatorTier:freelance`: the page shows only the items with that value. The **Query filters** button beside the search lists your properties under **Your properties**. See [Search and folders](https://docs.omnymous.com/library/search-and-folders#search).

## Check that it worked

The property is listed under its type in the panel, with its key, its kind and, when it is an attribution atom, the mark **atom**. Once ads that carry its values have run, the Attribution Lab lists it as a dimension of its own, at its stage, and the Library's **Performance** lens reads it too.

![The Image type in Properties with its two properties: Creator tier, a Choice marked atom, and Script version, a Number](https://docs.omnymous.com/media/library/properties/saved.623ee926.avif)

## Which properties can be credited

A property becomes an attribution atom only when its kind is a choice, a number or yes or no, and its type reaches the ads: creatives, pages, and the variables an ad is built from. Text never does. On a type whose items never appear in an ad, such as research, the line under the type reads **This type never reaches an ad’s lineage: its properties are form fields and search filters, not atoms.**

A type takes up to 20 properties, and a choice up to 50 values.

## If something goes wrong

| What you see                                                              | What to do                                                                                                     |
| ------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------- |
| “A label is required”                                                     | Type a **Label**.                                                                                              |
| “Keys are camelCase identifiers (letters and digits, 1–40 characters)”    | Start the key with a small letter and use only letters and digits, such as `shotStyle`.                        |
| “Duplicate key”                                                           | Another property of this type has that key. Choose another.                                                    |
| “A choice property needs at least one value”                              | Type the values under **Values**, separated by commas.                                                         |
| The type cannot be changed                                                | You have unsaved changes on this one. **Save** them or **Discard** them first.                                 |
| **Attribution atom** cannot be ticked                                     | The property is **Text**, or its type never reaches an ad.                                                     |
| **Save** cannot be pressed, and the foot reads “Requires the Member role” | Your role is Viewer. Ask an owner or an admin to change it.                                                    |
| A page made in Studio has no **Properties** tab                           | A page's fields are the page itself, changed in Page Studio, so your own properties cannot be filled in on it. |

Removing a property stops Omnymous reading it. The values already on your items stay where they are.

## Related

- [The item panel](https://docs.omnymous.com/library/inspector): Every Library item opens in the same panel, which says what the item is, how it performs, what you can do with it, how it was made and what it is made of.
- [Attribution Lab](https://docs.omnymous.com/analytics/creatives/attribution-lab): The Lab credits revenue to each hook, angle, avatar, offer and page inside your ads, and says how sure it is of each one.
- [Carried, Shared and Fitted](https://docs.omnymous.com/analytics/creatives/atom-models): The three ways the Lab passes an ad's credit on to the pieces inside it, what each one adds up to, and which question each answers.

---

Source: https://docs.omnymous.com/library/properties · Checked against Omnymous on 25 October 2026