Property model

A Property is a structured tag you apply to a Session item (or to a whole Session). Every Property is a Name / Value pair drawn from your account’s Property library.

Anatomy of a Property

Field	What it is
Name	The category. Examples: Status, Take, Speaker, Quality.
Value	The choice within that category. Examples: Approved, Take 1, Hero, Excellent.

When you create a Property, you add a Name (if it didn’t exist) and a Value under it. Both join your Property library and become available everywhere Properties are picked.

Where Properties can be applied

Most tagging happens on Session items — one row in the Session items table is one Session item. A whole Session can also carry Properties for tags that apply to the entire upload batch rather than any specific clip.

A single Session item can carry many Properties — typically one per Name (one Status, one Speaker), though nothing stops you from adding more.

Display attributes

Each Name and Value in the library has two display-only attributes:

• Color — A color shown on the Property chip. If a Value has no color of its own, it inherits its Name’s color.
• Order — Where the entry appears in dropdowns and the chip area. Reorder entries by dragging them in the Property editor.

Color and order can be changed independently of the Property’s text — see Color-code a Property.

Removing a Property vs. removing it from the library

Clicking the × on a Property chip removes that single application. The Name and Value stay in your Property library and on any other items where they’re applied. Two items carrying the “same” Property are independent — removing from one doesn’t affect the other.

Renaming the text of a Name or Value (for example, Approved → Approved by lead) updates the text everywhere it’s applied — those aren’t independent copies.

See also

• Build your Property library — how to add Names and Values.
• Apply Properties to many items at once
• Color-code a Property
• Glossary: Property, Property library, Session item