---
title: "Edit a Nexus Insight template JSON file"
canonical: "https://help.vicon.com/space/NexusInsight/163680067/Edit%20a%20Nexus%20Insight%20template%20JSON%20file"
format: markdown
---
When you create a new template or if you want to make changes to an existing template, you can edit the relevant JSON file to make these types of changes:

- The template’s unique identifier (ID)
- The name of the template that is displayed in Nexus Insight
- The template’s version number
- Whether the X-axis is time-based or cycle-based
- Whether moments and powers should be normalized by body weight
- Graph characteristics, such as which graphs are displayed, their titles and axis limits
- Colors and line widths used in the graphs

For information on where to locate the relevant JSON files, see [Maintain and restore the standard templates](https://vicon-help.atlassian.net/wiki/spaces/NexusInsight/pages/163684254).

## About the JSON file

The template JSON file contains the sections described in the following tables.

> Macro (toc)

> Macro (scroll-pagebreak)

### metadata section

The `metadata` section contains these settings:

> Macro (scroll-tablelayout)

| **Setting** | **Description** |
| --- | --- |
| > Macro (anchor)

 `id` | ID that uniquely identifies the template. Do not change it after you have saved the template.  
⚠ Make sure the ID is unique within all templates in the *Templates* folder.  
Valid input is ASCII and Unicode, up to 100 characters. |
| `label` | Name of the template displayed in Nexus Insight.   
Valid input is ASCII and Unicode, up to 100 characters. |
| `version` | Integer that defines the version of template that is currently stored. The default value is 1.  
When you change this integer, anyone editing a report with this template selected is warned about version deprecation. |
| `mergeTemplate` | Must always be set to **false**. |
| `defaultTimeSeries` | Boolean that specifies whether to use time-based or cycle-based X-axes:<br>- **true** (default for hitting template): time-based
- **false** (default for cutting and gait templates): cycle-based<br>See also [X-axis normalization](https://vicon-help.atlassian.net/wiki/spaces/NexusInsight/pages/163677368/Work+with+Nexus+Insight+graphs#X-axisNormalization). |
| `normalizeToBodyWeight` | Boolean that specifies whether moments and powers should be normalized by body weight:<br>- **true** (default): Moments and powers are normalized to body weight.                               
Measurement units: Nm/kg (moments) and W/kg (powers).
- **false**: Moments and powers are not normalized to body weight.   
Measurement units: Nmm (moments) and W (powers).<br>Forces are always normalized to body weight and represented as a percentage (%BW). |

> Macro (scroll-pagebreak)

### configuration section

The `configuration` section specifies which graphs are shown for kinematics (kinematicsCharts), moments (momentsCharts), powers (powersCharts), forces (forcesCharts), and EMG (emgsCharts).

You can add and name subsections, for example, for different joints.

For each graph, specify the following properties:

> Macro (scroll-tablelayout)

| **Property** | **Description** |
| --- | --- |
| `title` | Title of the graph  
Valid input is ASCII and Unicode, up to 48 characters. |
| `id` | Graph ID (must be unique within this template)  
Valid input is ASCII and Unicode, up to 100 characters. |
| `vLimits` | Vertical axis limits, used when setting the y-axis to fixed limits |
| `vAxis` | Vertical axis title  
Valid input is ASCII and Unicode, up to 48 characters. |
| `names` | Names of the graphs to group into this one. It uses a substring search, meaning that if you type `pelvisangles`, it includes all graphs with the substring `pelvisangles` (eg, `pelvisangles-x`, `pelvisangles-y`, and `pelvisangles-z`).<br>To view the names of the available graphs, see [Find the names of available graphs](#ChartNames). |

### chartConfig section

The `chartConfig` section enables you to specify line colors and widths. For each graph, you can change the following properties:

> Macro (scroll-tablelayout)

| **Property** | **Description** |
| --- | --- |
| `leftColor` | Line color in hexadecimal color code for left side data.  
Default: #fc3500 |
| `rightColor` | Line color in hexadecimal color code for right side data.   
Default: #699af0 |
| `neutralColor` | Line color in hexadecimal color code for data without an associated side.   
Default: #4396ff |
| `referenceColor` | Line color in hexadecimal color code for reference data.  
Default: #ffffff |
| `activeCycleWidth` | Line width in points for active gait cycles.   
Default: 2.75 points |
| `inactiveCycleWidth` | Line width in points for inactive gait cycles.   
Default: 0.75 points |

> ✅ **Tip**  
> ✅ If the model outputs in the C3D file and the names in the relevant template don't match, your data is not displayed in the report. To check that the names match, with the relevant template's JSON file open in a text editor, find the C3D output names using the **No template** option (see [Find the names of the available graphs](#ChartNames)).
> ✅ 
> ✅ ![image](media://6e20084c-ffa8-45a6-809f-66b3fd3ec36e)
> ✅ 
> ✅ ![image](media://23a6b27e-8ff9-4c65-936b-e0caad9becb8)
> ✅ 
> ✅ For information on the models that work with each of the standard templates, see [About the standard Nexus Insight report templates](https://vicon-help.atlassian.net/wiki/spaces/NexusInsight/pages/163684122).

> Macro (scroll-pagebreak)


    > Macro (anchor)




## Find the names of the available graphs

To find out the names of the graphs available for the current trial, select **No template (single trial only)** (see [View all graphs for a trial](https://vicon-help.atlassian.net/wiki/spaces/NexusInsight/pages/163683529)) and inspect the titles of the graphs shown there.

For example, the name that you can use for the following graph is **LHipAngles-x**.

![image](media://9c2a9252-ba74-4028-aa19-c6875dfe4ab4)

## Restart Nexus Insight

To select your new template and view the changes you've made, restart Nexus Insight.