Configuring File Storage

Please note: To configure a Storage Scenario, you will need to have ftrack Connect running.


ftrack is tracking your files as Asset versions and Components. A Component represents the existence of a file but does not tell you where the data is located. To keep track of this, ftrack uses the concept of Locations.

To simplify the setup of locations, a Storage Scenario can be used to instruct ftrack on how your files should be stored when publishing from ftrack connect or integrations.

  • When starting ftrack Connect for the first time, you will be asked to Configure a Storage Scenario.

Configuring Storage Scenario

A storage scenario can be configured to instruct ftrack on how your files should be stored and tracked.

The active storage scenario can be configured from System settings > Media Management > Storage scenario.


  • If you’ve already configured a storage scenario you will see the name of the currently active scenario.
Tip: You can also see the JSON parameters of the scenario, for advanced users and developers this may be good for debugging purposes.


If you haven’t already configured a scenario or want to update an existing scenario, you can press Configure Storage Scenario button. From here you will be able to select from a list of storage scenarios.



I cannot see anything in the Select storage scenario dropdown

  • Make sure that you have ftrack connect started and that you are properly logged in with a API key. 

Files are not being published using my newly configured storage scenario

  • Make sure to restart ftrack connect and any other applications that communicate with ftrack after configuring. This is necessary in order for the new storage scenario to become available.

Centralized Storage Scenario

By default, ftrack comes with a Centralized storage scenario. The centralized storage scenario is suitable for studios with one central storage where published files are stored.

The centralized storage scenario will copy your published files into a folder structure generated from the object names where the Asset version is published, along with the Asset name and version number.

As an example, we can say that you have a project named CarCommerical with a folder called Images. Now you publish a file component named front.png on an asset named DarkImage. It becomes version 3 of the asset and will yield a path:


Configured correctly ftrack will know where the storage is mounted on your machine and produce a file path suitable for your OS:

Please note: The storage that you intend to save your files on must be mounted and available on all computers that need to publish and import data.


Was this article helpful?
0 out of 1 found this helpful

Articles in this section