Prefs Property Keys

Table 2: Property keys in templater-options.json for adjusting Templater preferences

Key Name Type Default Description Notes
default_target String empty The name of the composition to version and process for output  
fix_layer_exp Boolean false Sets whether Templater fixes references in layer expressions when replicating comps Depending on the complexity of your project, setting this to true could slow down the versioning process.
missing_footage Integer 3 Specifies how Templater handles faulty footage references made in the spreadsheet

Values for this key can be any of the following:

0 - "ask me what to do"
1 - "let me find the footage asset"
2 - "skip the row"
3 - "use my branded placeholder"
4 - "cancel the process"

Integer values correspond to the position of the choices in the drop down menu in the preferences dialog within the Footage group. To avoid interruptions, do not set to 0 or 1. See Handling Faulty Footage References and Missing Footage for more information.

placeholder_audio String empty Specifies an absolute path to an audio file to be used when Templater cannot import a footage reference. Required when missing_footage is 3. If your project contains audio layers mapped to footage references in your spreadsheet, use this to maintain the integrity of your batch output tasks.
placeholder_visual String empty Specifies an absolute path to a video file to be used when Templater cannot import to an image or video source file referenced in the data source If your project contains image or video layers mapped to footage references in your spreadsheet, use this to maintain the integrity of your batch output tasks.
replica_comps_to_ame Boolean false Specifies whether Templater saves a copy of the current After Effects project file when a target comp is versioned and replicated with data Copies of the project file get stored in the location found in Templater's output location field. You can add that path as an Adobe Media Encoder (AME) watch folder to have it handle rendering. See Rendering a Batch of Replicas Using Adobe Media Encoder for more information.
replica_comps_to_queue Boolean false Specifies whether Templater should load a replicated composition into the After Effects render queue  
tsv_from_excel Boolean false Specifies whether the TSV (tab-separated value) file read by Templater was exported from either Microsoft Excel or Apple Numbers If you are seeing unexpected results in your text layers, change this setting to see if it fixes the issue.
suppress_ae_dialogs Boolean true Specifies whether Templater suppresses any notice, warning, or error dialogs that After Effects might assert during use This should be left alone unless you are troubleshooting issues you are encountering with Templater. Further, this setting only helps troubleshoot issues you might encounter within the graphical user interface of After Effects.
purge_caches Boolean false Specifies whether Templater should purge all caches after each job it processes Set this to true if you are finding that during batch processing Templater consumes too much RAM over time.
silence_logging Boolean false Specifies whether Templater should silence all logging output This should normally never bet set to true. You should really only use this if you are processing large batches and want Templater to skip logging in order to speed up processing.
unique_downloads Boolean false Specifies if Templater should download cloud-based footage references to unique files Turn this on to ensure you will get a unique download for every footage reference listed in the data source.
empty_is_faulty Boolean true Specifies how Templater should regard empty or null cell values when mapped to footage layers. If enabled, empty cell and null values are treated as faulty footage references if the data is mapped to a footage layers. Enabling this invokes the selected action found in the "missing_footage" property above.
bot Object   A group of keys used for configuring The Bot for Templater The keys in this group refer to the "Bot Settings" area of the Templater Preferences panel.
remote_json Object   A group of keys for setting up Basic Authentication and additional headers for remote JSON data sources  
remote_json.username String empty The username for a remote JSON data source that is secured with Basic Authentication.  
remote_json.password String empty The password for a remote JSON data source that is secured with Basic Authentication  
remote_json.headers Object   A group of keys that specify any additional headers needed for access a remote JSON data source You can add any header to the request that Templater makes to a server that responds with a properly formatted JSON object array. Enter the header name for the property key, and the header content for the property value