Using lists

When data grows it becomes important to group things together. ftrack uses the concept of lists to group items of the same type. A list can contain asset versions or objects. It has a type, an owner and can either be open or closed. While list categories are global, a list itself is specific to a project and cannot be shared between projects.

Tip

Example usage: Trailer shots

A project you are managing has a trailer you need to deliver shots to. For easy access and convenience you can add the shots to a Trailer 1 shot list.

The lists on a project are found categorised in the top of the project outliner.

To view the contents of a list, find the list in the outliner to the left and click to show its contents to the right.

A list can be either open or closed. Open means that the list is active and open for submission. A closed list is the opposite, it’s hidden and not meant to be submitted to.

You can change the list from open to closed and vice versa in the sidebar of the list.

To create a new list, go to the Lists page on a project by clicking Lists in the outliner to the left and clicking the Create button.

This will bring up a dialog with some settings:
​Name
Name of the list, used in menus.
​Open
If it’s open or closed.
​Category
Category of the list.
​Accepts
Type of objects accepted in the list. 

The dialog will also contain fields for custom attributes. Enter the information and click Create when you’re done.

To add a list from a selection in a spreadsheet, select one or more items in a spreadsheet and then right click and select Lists > Create from selected.

To edit a list, go to the Lists page on the project by clicking Lists in the outliner to the left. Find the list and click the edit icon to open the Edit dialog. The Edit dialog is the same as the Create dialog, but pre-entered with the values of the list you want to edit.

To remove a list, go to the Lists page on the project by clicking Lists in the outliner to the left. Find the list and click the remove icon. This will bring up a confirmation dialog.

Note

When removing a list you only remove the list itself, not the items on it.

To add items to a list or remove items from a list, go to a spreadsheet and select item(s). Right click on the selected items and select Lists > Add selected to > [ List category ] > [ Name of the list ] to add the items to the selected list, or Lists > Remove selected from > [ List category ] > [ Name of the list ] to remove the items from the selected list.

Moving items between lists is similar to adding or removing items, right click on the selected item(s) and select Lists > Move selected to > [ List category ] > [ Name of the list ] to move them to the selected list.

Custom attributes can be added to lists and those can be used as any other attributes. A custom attribute can be added via System settings ‣ Advanced ‣ Custom attributes. Make sure to select List in the Add to box when creating an attribute to make it show up in the Lists toolbar.