> For the complete documentation index, see [llms.txt](https://docs.specsolutions.eu/specsync/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.specsolutions.eu/specsync/reference/configuration/configuration-synchronization/configuration-synchronization-iterationpath.md).

# iterationPath

This configuration section contains settings to configure how the test case *iteration path* field should be updated.

Read more about the setting the *area path* and *iteration path* fields in the [Add new test cases to an Area or an Iteration](/specsync/features/push-features/add-new-test-cases-to-an-area-or-an-iteration.md) concept description.

The following example shows the available options within this sub-section.

```javascript
{
  ...
  "synchronization": {
    ...
    "iterationPath": {
      "mode": "setOnLink",
      "value": "\\Iteration1"
    },
    ...
  },
  ...
}
```

The `iterationPath` setting is a shortcut for configuring the [`synchronization/fieldUpdates` section](/specsync/reference/configuration/configuration-synchronization/configuration-synchronization-fieldupdates.md). The example above is equivalent to the following `fieldUpdates` setting:

```javascript
{
  "synchronization": {
    "fieldUpdates": {
      "System.IterationPath": {
        "value": "project-name\\Iteration1",
        "update": "onCreate"
      }
    }
  },
}
```

## Settings

| Setting | Description                                                                                                                                                                                                                                                                                                                                                             | Default                        |
| ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------ |
| `mode`  | <p>Specifies how the iteration path of the test case should be updated. Available options: <code>notSet</code> and <code>setOnLink</code>. (Default: <code>notSet</code>)</p><ul><li><code>notSet</code>: the path is not set</li><li><code>setOnLink</code>: set the path when the test case created and linked to the scenario, but not to update later on.</li></ul> | `notSet`                       |
| `value` | The iteration path to set for test cases (e.g. `\\Iteration1`). The project name prefix can be omitted.                                                                                                                                                                                                                                                                 | mandatory for mode `setOnLink` |

{% content-ref url="/pages/-LVwFCLmwNCOYz1dKMTr" %}
[synchronization](/specsync/reference/configuration/configuration-synchronization.md)
{% endcontent-ref %}

{% content-ref url="/pages/-LVwFCLiKB3ACJLwVZGP" %}
[Configuration reference](/specsync/reference/configuration.md)
{% endcontent-ref %}