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.

Viewing a list¶

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.

Opening or closing a list¶

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.

Creating a 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.

Creating a list from selection¶

../_images/create_list_from_selected.jpg

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.

Editing a list¶

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 preentered with the values of the list you want to edit.

Removing a list¶

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.

Adding or removing items¶

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¶

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.

Adding custom attributes to lists¶

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.

Linking a list to a task¶

A list can be linked to a specific task. Imagine that you have a bunch of asset versions on a list that you want to do something with: link the list of versions to a task and make it easy this way to keep track of them.