All about fields

Shotgun uses fields to store information on entities, such as Shots or Assets. Every entity has a number of built-in field types and you can create your own fields to store custom information. Some fields are common to most entities in Shotgun, such as id, Project, Status, and Thumbnail. Others are customized to more entity-specific functionality, such as the Cut In and Cut Out fields that are used to store editorial information on Shots.

Showing fields on a page

Shotgun has three different ways to view a page: list, detail, and thumbnail.

List page

To add a field as a column on a list page, click on the Insert Column Add field button button (on the right side of the column headers) and choose the field from the list.

Choose field

You can also do this by right-clicking on any column header and choosing “Insert Column.” Or you can click on the Fields button, and select “Manage Fields...”

Detail page

On detail pages, you can click "Configure fields..." in the top section to insert other fields.

Field on a detail page

Thumbnail page

On Thumbnail pages, click on the Fields Fields Button button in the toolbar to add other fields under each Thumbnail.

Pro tip: Remember to save the page after adding fields to keep any changes you made.

Creating fields

You can create a new field on any list page (you can also customize existing fields). As an example, on a Shot list page, click on the Fields button, and choose “Manage Shot Fields…” This will bring up a list of all the fields that exist on the Shot entity on your Shotgun site already.

Note that fields can be hidden in a particular Project, so it's a good idea to scan this list to see if the field you need may already exist, but just be hidden. If that's the case, click on the Hidden field button to unhide the field in your current Project.

If the field you need does not exist, then select “Add a new field” at the bottom of the “Manage Shot Fields…” window to create a new field.

Basic fields

Some basic field types don't require much customization.

Note: Formatting options for some of these field types (such Currency and Date) can be found in Site Preferences.

Hiding fields from a Project

You can choose which fields to hide and which fields to show in a Project by toggling their visibility from the "Manage Fields" menu or by going to a Project's Tracking Settings.

Deleting Fields

You can send fields to the trash via "Manage Fields..."

Manage fields Trash field

To permanently delete a field, so you can re-use those field names, you must delete the field on the Trash page.

Linked Fields

In Shotgun, you can link through single Entity fields to get information. However, you cannot link through Multi-entity fields.

Defining a default value for a field from the Shotgun web UI

You can define a default value for a field via the configuration setting in the Status field. At the bottom you can see where you can set default values.

You can also set up a page with a Saved Filter for specific values.

As an example, if you have a filter like the one above set up on a page of Assets, whenever you create a new Asset, the Type field will be populated with “Prop” and the Description field will be pre-populated with “These are Props.”

A third option is to generate a URL to pre-populate creation forms.

 

Follow