> ## Documentation Index
> Fetch the complete documentation index at: https://docs.activeviam.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Custom workflow settings

> How to configure custom legacy workflow settings in Atoti Limits, including adding workflows to limitWorkflows or exceptionWorkflows in application.yml with workflow name, process ID, and participants

When adding a custom workflow, the user needs to update the project settings to pick up the workflow.

### Backend settings

The workflow needs to be included in the [Limits workflow properties](../../../../user-ref/properties/property-files/application-yml#section-limit-workflow) based upon its type. If the workflow is linked with the lifecycle of the limit, then it belongs under `limitWorkflows`. If the workflow should be instantiated upon evaluation, then it belongs under `exceptionWorkflows`.
To add the new workflow, add a new entry to either `limitWorkflows` or `exceptionWorkflows` based on its type with the following format:

```yaml theme={"languages":{"custom":["/engine/python-sdk/0.9/languages/pycon.tmLanguage.json"]}}
    <WORKFLOW_NAME>:
      key: <WORKFLOW_PROCESS_ID>
      participants: <WORKFLOW_PARTICIPANTS>
```

* `<WORKFLOW_NAME>` is a name given to the workflow by the user.
* `<WORKFLOW_PROCESS_ID>` is the value of the `<process id=` tag defined at the beginning of the bpmn file.
* `<WORKFLOW_PARTICIPANTS>` is a comma-separated list of users who have authority to move a limit along the workflow. This may not be required.

Below is an example from the Limits `application.yml` with a custom workflow:

```yaml theme={"languages":{"custom":["/engine/python-sdk/0.9/languages/pycon.tmLanguage.json"]}}
    limitWorkflows:
        StraightThrough:
          key: limit-process-instance.straight-through
        FourEyes:
          key: limit-process-instance.four-eyes
          participants: Approvers
        SixEyes:
          key: limit-process-instance.six-eyes
          participants: Examiners,Approvers
        Custom:
          key: custom-workflow-instance.key
          participants: Approvers
      exceptionWorkflows:
        Exception:
          key: limit-process-instance.exception
```

### Frontend settings

No frontend settings are required.