Standard fields for tracking cut information – Shotgun Support

Below is a description of the standard fields Shotgun uses to track cut information based on actual use cases and client feedback. These standards are published to help ensure tools and integrations with third-party applications work consistently for all Shotgun clients.

Note: Only still images or movie files are officially supported.

Shot fields

Field name	(field type)	`internal_field_name`	Description and usage	Example
Cut In	(number)	`sg_cut_in`	The first frame used in the Cut. This input comes from editorial and is used for playback of movie and frames.	15
Cut Out	(number)	`sg_cut_out`	The last frame used in the Cut. This input comes from editorial and is used for playback of movie and frames.	125
Cut Duration	(number)	`sg_cut_duration`	The duration of this Shot in the Cut.	111
Cut Order	(number)	`sg_cut_order`	The order that the Shot plays in the overall Cut for the entire Project. Used for sorting Shots and Versions of Shots when playing in cut order, and pulling in neighboring Shots of Versions to the current one being viewed.	210000007
Head In	(number)	`sg_head_in`	The first frame number that footage is available for this Shot.	11
Tail Out	(number)	`sg_tail_out`	The last frame number that footage is available for this Shot.	130
Working Duration	(number)	`sg_working_duration`	The full duration of available frames in this Shot from Head In to Tail Out.	120

Version fields

Field name	(field type)	`internal_field _name`	Description and usage	Example
Uploaded Movie	(file/link)	`sg_uploaded_movie`	The file field to contain the uploaded movie file. Used for playback of lower resolution movie media stored in Shotgun.
Path to Movie	(text)	`sg_path_to_movie`	The location of the movie on your local filesystem (not uploaded). Used for playback of lower resolution movie media stored locally.	/path/to/movie.mov
Movie Aspect Ratio	(float)	`sg_movie_aspect_ratio`	The aspect ratio of the movie. Used to format the image correctly for viewing.	1
Movie Has Slate	(checkbox)	`sg_movie_has_slate`	Indicates whether the movie file has a slate or not. This is used to include or omit the slate from playback.	[✔]
Path to Frames	(text)	`sg_path_to_frames`	The location of the high resolution frames on your local filesystem. Used for playback of high resolution frames.	/rvshotgundemo/BBB_Short/08_a-team/012/ANIM/001/BBB_08_a-team_012_ANIM_001.#.jpg
First Frame	(number)	`sg_first_frame`	The first frame number contained in the Version. Used in playback of the movie or frames to calculate the first frame available in the Version.	11
Last Frame	(number)	`sg_last_frame`	The last frame number contained in the Version. Used in playback of the movie or frames to calculate the last frame available in the Version.	130
Frames Aspect Ratio	(float)	`sg_frames_aspect_ratio`	The aspect ratio of the high resolution frames. Used to format the image correctly for viewing.	1
Frames Have Slate	(checkbox)	`sg_frames_have_slate`	Indicates whether the frames have a slate or not. This is used to include or omit the slate from playback.	[ ]
Department	(text or list)	`sg_department`	The department that submitted the Version. This is used to find the latest Version from the same department.	ANM