This feature is currently only available for local installations of ftrack. How to enable (Custom layouts).
How attributes are presented in the create dialogs, sidebar info tab and sidebar header can be customized through JSON layout files. The files should be saved with the .json extension. The folder structure among the layout files does not matter and can therefore be used organize the layouts in a flexible way.
There can only be one layout per JSON configuration file. For multiple layouts, use multiple files.
A layout JSON configuration need to contain the following:
Where type defines that it is a layout, the id identifies where this layout should apply in ftrack, criteria is a filter defining when it should be applied and items is the actual groups and attributes configuration.
The criteria specifies when a layout is valid and should be applied. Valid criteria are:
The entity to apply this layout for. Valid entity_types are Project, List, User, AssetVersion, Task or any of the custom objects.
The id of a workflow schema.
The id of a project.
schema_id and project_id should not be used together.
Here is an example of how and in what order criteria is matched:
# 1 - Try to match against a project and entity.
}# 2 - Try to match against schema and entity.
}# 3 - Try to match against entity only which is useful for defaults.
If not matching layout is found the built-in default layouts will be used.
Each layout is identified by an id that define where is should be applied in ftrack. The following identifiers are valid:
The create dialogs for project and entities such as tasks.
The sidebar info tab.
The sidebar header attributes.
The sidebar header will not show groups and only have enough space for 3 attributes.
The actual layouts are composed of groups and attributes. Attributes currently have to be in a group and groups cannot be nested.
Here is an example of a layout with groups and attributes:
"label": "Group at the top",
"label": "Next group",
"label": "Task status",
Groups should have id, type and label together with items and attributes should have type, id and could have a label if the default should be overridden.
Note: A group with the label “General” is handled differently and attributes in that group will appear as not being part of a group.
After following the example above, the sidebar of Task will look like this:
Attributes are identified through their id.
Custom attributes are identified through their id with the special prefix “__”. The id of a custom attribute could therefore be something like __7366e4fa-6765-11e1-b855-f23c91df25eb
Objects (e.g. Episode, Sequence, Shot, Task)
- pm - This is the +/- of bid vs worked.
- attached_to - Only for sidebar_header.
- asset_attached_to - Only for sidebar_header.
- task_attached_to - Only for sidebar_header.