> For the complete documentation index, see [llms.txt](https://docs.pentaho.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.pentaho.com/pdia-admin/9.3-administer/manage-the-pentaho-system/manage-the-pentaho-repository/set-pdi-version-control-and-comment-tracking-options.md).

# Set PDI version control and comment tracking options

Pentaho Data Integration (PDI) can track versions and comments for jobs, transformations, and connection information when you save them. You can turn version control and comment tracking on or off by modifying their related statements in the `repository.spring.properties` text file.

**Note:** By default, version control and comment tracking are disabled (set to false).

## Editing the version control statement

1. Exit from the PDI client (also called Spoon).
2. Stop the Pentaho Server.

   See the **Install Pentaho Data Integration and Analytics** document for instructions on starting and stopping the Pentaho Server..
3. Open the `pentaho-server/pentaho-solution/system/repository.spring.properties` file in a text editor.
   * To enable version control: Edit the **versioningEnabled** statement and set it to: `true`

     ```
     versioningEnabled=true
     ```
   * To disable version control: Edit the **versioningEnabled** statement and set it to: `false`

     ```
     versioningEnabled=false
     ```

     **Note:** If you disable version control, comment tracking is also disabled.
4. Save and close the file.
5. Start the Pentaho Server.

   See the **Install Pentaho Data Integration and Analytics** document for instructions on starting and stopping the Pentaho Server..
6. Start the PDI client. 
7. Verify that version control is set as you intended. 

### Verifying the version control option

* Connect to the Pentaho Repository.
* In the PDI client, click **Tools** > **Explore**.
* In the Repository Explorer window, click on the **Browse** tab, then click on a file name.
* Verify that version control is enabled or disabled:
  * **Enabled**

    You can see the **Access Control** tab, and the **Version History** tab is visible.

    ![Version History tab in the PDI client](/files/HQGJO5I4PlS58XhexVL4)
  * **Disabled**

    You can see the **Access Control** tab, but the **Version History** tab is hidden.

    ![Access Control tab in the PDI client](/files/mpnjVm2nq4nQTpWZrmq7)

## Editing the comment tracking statement

1. Exit from the PDI client (also called Spoon).
2. Stop the Pentaho Server.
3. Open the `pentaho-server/pentaho-solution/system/repository.spring.properties` file in a text editor.
   * To enable comment tracking: Edit the **versionCommentsEnabled** statement and set it to `true`.

     ```
     versionCommentsEnabled=true
     ```
   * To disable comment tracking: If you want version control, but not comment tracking:

     * Edit the **versioningEnabled** statement and set it to `true`.
     * Edit the **versionCommentsEnabled** statement and set it to `false`.

     ```
     versioningEnabled=true
     versionCommentsEnabled=false
     ```
4. Save and close the file.
5. Start the Pentaho Server.
6. Start the PDI client.
7. Verify that Version Control and Comment Tracking are set as you intended.

### Verifying the comment tracking option

* Connect to the Pentaho Repository.
* In the PDI client, click **Tools** > **Explore**.
* In the Repository Explorer window, click on the **Browse** tab, then click on a file name.
* Verify that comment tracking is enabled or disabled:
  * **Enabled**

    The **Version History** tab appears with the **Comments** field. When you save a transformation, job, or connection information, you are prompted to enter a comment.

    ![Version History tab showing the Comments column in the PDI client](/files/G4CmWRcJh7lwpqcdkssc)
  * **Disabled**

    The **Version History** tab appears and the **Comment** field is hidden. When you save a transformation, job, or connection information, you are no longer prompted to enter a comment.

    ![Version History tab with the Comments column hidden in the PDI client](/files/9jtiuhy2uc4ll65cejlD)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.pentaho.com/pdia-admin/9.3-administer/manage-the-pentaho-system/manage-the-pentaho-repository/set-pdi-version-control-and-comment-tracking-options.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.