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

# Configuring Redline profiles within Group Policy

> This article is for system administrators who are interested in using Group Policy specifically to configure Redline comparison profiles settings for their users using Draftable Legal. This article will show the additional steps required in addition to Group Policy configuration in order to get this setting configured properly.

## Setting up

Ensure you have already followed the [Draftable Group Policy guide](/hc/en-us/articles/18763487262105-Configuring-settings-with-Group-Policy-Draftable-Legal) in respect to adding the templates for the group policy. 

Open the Group Policy Editor (via Control Panel)

After installing the group policy template you should see following policies in the **Draftable Legal** section:

<Frame>
  <img src="https://mintcdn.com/draftable/B2kzCCfUvVdHgQCw/images/draftable-legal/image-225.png?fit=max&auto=format&n=B2kzCCfUvVdHgQCw&q=85&s=a572b60d3d3ef59a6369c9525fef403c" alt="" width="650" height="463" data-path="images/draftable-legal/image-225.png" />
</Frame>

## Getting the profile JSON ready

To pre-configure the Redline settings profiles within group policy, you must already have the JSON for profile ready to be added into the group policy setting. To get this, see the process below:

<Steps>
  <Step>
    Go to the **Redline** section within the settings menu

    <Frame>
      <img src="https://mintcdn.com/draftable/B2kzCCfUvVdHgQCw/images/draftable-legal/image-226.png?fit=max&auto=format&n=B2kzCCfUvVdHgQCw&q=85&s=2bfce501379e0b8c2106be1bb456b1b6" alt="" width="650" height="508" data-path="images/draftable-legal/image-226.png" />
    </Frame>
  </Step>

  <Step>
    Select **Add profile,** then give the profile a name and click **OK**

    <Frame>
      <img src="https://mintcdn.com/draftable/B2kzCCfUvVdHgQCw/images/draftable-legal/image-227.png?fit=max&auto=format&n=B2kzCCfUvVdHgQCw&q=85&s=e829f72fab4fbfcf961513e9856382a5" alt="" width="650" height="297" data-path="images/draftable-legal/image-227.png" />
    </Frame>
  </Step>

  <Step>
    Start building the profile as required for your user by selecting the settings desired. Then once you have finished building the profile, export it by clicking on the option icon, and then selecting **export**

    <Frame>
      <img src="https://mintcdn.com/draftable/B2kzCCfUvVdHgQCw/images/draftable-legal/image-228.png?fit=max&auto=format&n=B2kzCCfUvVdHgQCw&q=85&s=c8453e05113823efc0c18abae2c60d07" alt="" width="779" height="199" data-path="images/draftable-legal/image-228.png" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/draftable/B2kzCCfUvVdHgQCw/images/draftable-legal/image-229.png?fit=max&auto=format&n=B2kzCCfUvVdHgQCw&q=85&s=e88f6c1b49e405dab5c675a0254e1d51" alt="" width="238" height="135" data-path="images/draftable-legal/image-229.png" />
    </Frame>
  </Step>

  <Step>
    A new window will appear to save the profile to your desired location. Do so and select **save**

    <Frame>
      <img src="https://mintcdn.com/draftable/B2kzCCfUvVdHgQCw/images/draftable-legal/image-230.png?fit=max&auto=format&n=B2kzCCfUvVdHgQCw&q=85&s=ac41cbd20f4a9db425b43cd0c951e7c2" alt="" width="749" height="433" data-path="images/draftable-legal/image-230.png" />
    </Frame>
  </Step>

  <Step>
    Navigate to where the JSON has been saved and access the file

    <Frame>
      <img src="https://mintcdn.com/draftable/B2kzCCfUvVdHgQCw/images/draftable-legal/image-231.png?fit=max&auto=format&n=B2kzCCfUvVdHgQCw&q=85&s=19e89ae62da5ebf81f0e056a3abb3023" alt="" width="1437" height="169" data-path="images/draftable-legal/image-231.png" />
    </Frame>
  </Step>
</Steps>

This is your profile JSON data, and is required for your group policy Redline profile settings. When required, copy the entire JSON string and save it into your group policy, which is outlined in the next step.

## Configuring Redline profiles within group policy

There are a few components to the Redline profiles configuration in group policy. Configuring Redline profiles to be loaded for the user, team allocation for what profiles users can see and setting the default Redline profile used. 

### Configuring the team name for user

As an administrator, you can allocate a user to a *team* as a way to further distinguish what profiles they can use from the Redline settings configured by group policy. Mutliple team names can exist, which has the benefit of easily allocating which profiles are loaded for different groups of users.

<Note>**Note:** This step is entirely optional, and only required if you wish for certain users to only use certain Redline profiles.</Note>

<Steps>
  <Step>
    Using the Group policy editor of choice, navigate to the **Draftable Legal** policy templates

    <Frame>
      <img src="https://mintcdn.com/draftable/B2kzCCfUvVdHgQCw/images/draftable-legal/image-232.png?fit=max&auto=format&n=B2kzCCfUvVdHgQCw&q=85&s=7ca51641ed171e40cabd8e83b52ed671" alt="" width="1298" height="870" data-path="images/draftable-legal/image-232.png" />
    </Frame>
  </Step>

  <Step>
    Double click on **User Team Name**

    <Frame>
      <img src="https://mintcdn.com/draftable/B2kzCCfUvVdHgQCw/images/draftable-legal/image-233.png?fit=max&auto=format&n=B2kzCCfUvVdHgQCw&q=85&s=bfd0856a278734dd27323b8460e301f7" alt="" width="679" height="627" data-path="images/draftable-legal/image-233.png" />
    </Frame>
  </Step>

  <Step>
    Enable the policy and set a string based name for the user in the **Set team name for the user** field. Alternatively, putting a wildcard **\*** for the user, will allow them to see all profiles from all teams.

    <Frame>
      <img src="https://mintcdn.com/draftable/B2kzCCfUvVdHgQCw/images/draftable-legal/image-234.png?fit=max&auto=format&n=B2kzCCfUvVdHgQCw&q=85&s=28001560d5fc75351efc327413d23cd8" alt="" width="683" height="630" data-path="images/draftable-legal/image-234.png" />
    </Frame>
  </Step>

  <Step>
    Click **Apply** and then **OK** for the policy to take effect.
  </Step>
</Steps>

The user now has a team name allocated to their account via group policy.

### Configuring the Redline profiles

You can configure up to 10 Redline profiles that can be automatically loaded into your user machines. Here is how you configure the Redline profiles:

<Steps>
  <Step>
    Using the Group policy editor of choice, navigate to the **Draftable Desktop Pro** policy templates

    <Frame>
      <img src="https://mintcdn.com/draftable/B2kzCCfUvVdHgQCw/images/draftable-legal/image-235.png?fit=max&auto=format&n=B2kzCCfUvVdHgQCw&q=85&s=ea3ffd0aa29475f19912897060c54cf8" alt="" width="1298" height="870" data-path="images/draftable-legal/image-235.png" />
    </Frame>
  </Step>

  <Step>
    Double click on the Redline setting profile you wish to configure

    <Frame>
      <img src="https://mintcdn.com/draftable/B2kzCCfUvVdHgQCw/images/draftable-legal/image-236.png?fit=max&auto=format&n=B2kzCCfUvVdHgQCw&q=85&s=28f6e9addf358df060d4deae04c20eab" alt="" width="680" height="626" data-path="images/draftable-legal/image-236.png" />
    </Frame>
  </Step>

  <Step>
    Enable the policy and paste the Redline profile JSON (that we created using the processed outlined earlier in this article) into the **Paste Redline Profile JSON here** field.

    <Frame>
      <img src="https://mintcdn.com/draftable/B2kzCCfUvVdHgQCw/images/draftable-legal/image-237.png?fit=max&auto=format&n=B2kzCCfUvVdHgQCw&q=85&s=b61e1c371cc2df7843a7e9ccdedb22bf" alt="" width="677" height="627" data-path="images/draftable-legal/image-237.png" />
    </Frame>
  </Step>

  <Step>
    *Optionally:* you can enter the team name of the Redline setting profile, so that only users with that team name can see that profile. If you would like to do this, add the team name in the **Team name** field.

    <Frame>
      <img src="https://mintcdn.com/draftable/B2kzCCfUvVdHgQCw/images/draftable-legal/image-238.png?fit=max&auto=format&n=B2kzCCfUvVdHgQCw&q=85&s=2d332e760ab3a2ee08f68bdddfd45cde" alt="" width="678" height="625" data-path="images/draftable-legal/image-238.png" />
    </Frame>
  </Step>

  <Step>
    Click **Apply** and then **OK** for the policy to take effect.
  </Step>
</Steps>

Next time your user loads Draftable Legal, the Redline profiles configured in group policy will be loaded for the user to utilize.

### Setting the default profile

You can select the default Redline profile that is used when a user loads Draftable Legal. To do this follow the procedure below:

<Steps>
  <Step>
    Using the Group policy editor of choice, navigate to the **Draftable Desktop Pro** policy templates

    <Frame>
      !\[]<img src="https://mintcdn.com/draftable/B2kzCCfUvVdHgQCw/images/draftable-legal/image-239.png?fit=max&auto=format&n=B2kzCCfUvVdHgQCw&q=85&s=38b50be441d6ccd676e87235ffb963c6" alt="" width="1298" height="870" data-path="images/draftable-legal/image-239.png" />
    </Frame>
  </Step>

  <Step>
    Double click on the **Redline Default Profile Name** policy

    <Frame>
      <img src="https://mintcdn.com/draftable/B2kzCCfUvVdHgQCw/images/draftable-legal/image-240.png?fit=max&auto=format&n=B2kzCCfUvVdHgQCw&q=85&s=eab5e5963f9135c6155b89fac5cae9c5" alt="" width="680" height="630" data-path="images/draftable-legal/image-240.png" />
    </Frame>
  </Step>

  <Step>
    Enable the policy and enter the name of the profile you wish to load as default into the **Set default Redline Profile name** field.
    <Note>**Note:** This is the name of profile you saved it as, not the name of the policy.</Note>

    <Frame>
      <img src="https://mintcdn.com/draftable/B2kzCCfUvVdHgQCw/images/draftable-legal/image-241.png?fit=max&auto=format&n=B2kzCCfUvVdHgQCw&q=85&s=136e93c5d98e58a8c3fcb5eb7174a371" alt="" width="679" height="631" data-path="images/draftable-legal/image-241.png" />
    </Frame>
  </Step>

  <Step>
    Click **Apply** and then **OK** for the policy to take effect.
  </Step>
</Steps>

Next time your user loads Draftable Legal, the selected default Redline profile policy will be loaded.

## Configuring locking specific settings across all Profiles

From v2.15.300, Draftable Legal allows administrators to override any Profile setting using a "Redline Settings Base Profile" in Group Policy. This is designed to allow some Profile settings (e.g. author of changes) to be kept consistent across all profiles while still allowing administrators and end user to create custom profiles by changes other 'unlocked' settings. This section outlines how administrators can lock specific Profile settings across all Profiles with this functionality.

Locking in Draftable Legal is deliberately **per setting, not per profile**. You nominate the individual settings that must stay consistent for everyone, and every setting you do not nominate remains available to the user. This lets you fix the things that matter to the firm, such as the author applied to changes or the redline markup colours, without forcing users to build a profile from scratch when they need to adjust something for the document in front of them.

<Note>
  **Which policy should you use?** A numbered **Admin Redline Profile** governs only itself. Settings in a profile you deploy that way always take precedence over changes a user makes to it, and are restored whenever profiles are reloaded, but they do not carry across to profiles the user creates themselves.

  To apply a setting across **every** profile, including profiles users create, put the JSON in the **Redline Settings Base Profile** policy and list the setting in its `Enforced` array. Enforced values are re-applied from the base profile each time profiles are loaded, so a change a user makes to an enforced setting does not persist.
</Note>

### Configuring and locking specific settings across all Profiles

<Steps>
  <Step>
    The "Redline Settings Base Profile" policy looks the same as all other Redline profiles group policy items, but it has the additional configurable property called "Enforced" that can be added to the JSON string.

    Administrators can nominate keys (i.e. Redline settings) that are to be "Enforced" at the end of the profile JSON by listing them. This configures the setting using the key in the Redline profile value and locks this setting from end user configuration. Below is an example of the Redline profile JSON showing the **Enforced** key added for locking down settings.

    ```json expandable theme={null}
        {  
    	    "Name": "My Profile",  
    	    "Version": 1,  
    	    "Created": "2024-05-27T11:46:13.6253904Z",  
    	    "Updated": "2024-05-27T11:46:13.6253904Z",  
    	    "CompareHeadersAndFooters": null,  
    	    "CompareBulletsAndNumberings": true,  
    	    "CompareTables": false,  
    	    "CompareImages": false,  
    	    "CompareTextBoxes": true,  
    	    "CompareHeaders": true,  
    	    "CompareFooters": true,  
    	    "CompareCoverPage": true,  
    	    "CompareHiddenText": false,  
    	    "CompareTablesOfContents": true,  
    	    "CompareWatermarks": true,  
    	    "CompareFootnotesAndEndnotes": true,  
    	    "StyleChangesEnabled": true,  
    	    "StyleChangeConfig": 3,  
    	    "CommentOption": 0,  
    	    "SmallChangesLevel": 0,  
    	    "CaseSensitivity": 0,  
    	    "DefaultAuthorOption": 1,  
    	    "DefaultAuthorCustomOptionValue": "Draftable",  
    	    "DefaultAuthorLauncherDropdownVisible": false,  
    	    "DefaultSummaryPagePosition": 0,  
    	    "DefaultTrackChangesBehaviour": 0,  
    	    "MovesEnabled": true,  
    	    "RedlineMarkupScheme": {  
    	        "TextDeletion": {  
    	            "Underline": 0,  
    	            "Strikethrough": 1,  
    	            "HighlightColour": null,  
    	            "TextColor": "181, 8, 46",  
    	            "WordApiTextDecoration": 4,  
    	            "WordApiTextColor": 6  
    	        },  
    	        "TextInsertion": {  
    	            "Underline": 1,  
    	            "Strikethrough": 0,  
    	            "HighlightColour": null,  
    	            "TextColor": "55, 110, 150",  
    	            "WordApiTextDecoration": 3,  
    	            "WordApiTextColor": 9  
    	        },  
    	        "TextMoveFrom": {  
    	            "Underline": 0,  
    	            "Strikethrough": 2,  
    	            "HighlightColour": null,  
    	            "TextColor": "44, 98, 52",  
    	            "WordApiTextDecoration": 6,  
    	            "WordApiTextColor": 11  
    	        },  
    	        "TextMoveTo": {  
    	            "Underline": 2,  
    	            "Strikethrough": 0,  
    	            "HighlightColour": null,  
    	            "TextColor": "44, 98, 52",  
    	            "WordApiTextDecoration": 5,  
    	            "WordApiTextColor": 11  
    	        },  
    	        "CellDelete": {  
    	            "HighlightColor": "252, 230, 244",  
    	            "WordApiCellColour": 0  
    	        },  
    	        "CellInsert": {  
    	            "HighlightColor": "225, 242, 250",  
    	            "WordApiCellColour": 2  
    	        },  
    	        "CellMerge": {  
    	            "HighlightColor": "252, 227, 208",  
    	            "WordApiCellColour": 4  
    	        },  
    	        "CellSplit": {  
    	            "HighlightColor": "254, 244, 222",  
    	            "WordApiCellColour": 1  
    	        },  
    	        "RevisedLine": {  
    	            "Mark": 0  
    	        }  
    	    },  
    	    "FilenameOutputFormat": "",  
    	    "Enforced": [  
    	        "RedlineMarkupScheme",  
    	        "CommentOption"  
    	    ]
    	}
    ```

    As you can see above, the keys "CommentOption" and "RedlineMarkupScheme" are now enforced.

    <Warning>
      Names in the `Enforced` array are **case sensitive** and must be spelled exactly as shown below. An entry that does not match is ignored silently, so the setting stays unlocked with no warning. Check your spelling and capitalisation carefully after editing the array.

      `Enforced` takes **setting names**, which are not always identical to the JSON keys used elsewhere in the same profile. The comparison resolution setting is the one to watch: the value is stored under `ComparisonResolution` in current profiles (and under `SmallChangesLevel` in much older version 1 profiles), but the name you must list in `Enforced` is always `ComparisonResolution`.
    </Warning>

    For reference, the following settings can be listed as enforced.

    **What to compare**

    ```json expandable theme={null}
    "CompareBulletsAndNumberings"
    "CompareTables"
    "CompareImages"
    "CompareTextBoxes"
    "CompareHeaders"
    "CompareFooters"
    "CompareCoverPage"
    "CompareHiddenText"
    "CompareTablesOfContents"
    "CompareWatermarks"
    "CompareMathEquations"
    "CompareFootnotesAndEndnotes"
    "CompareFootnoteNumbering"
    ```

    **Comparison behaviour**

    ```json expandable theme={null}
    "ComparisonResolution"
    "CaseSensitivity"
    "MovesEnabled"
    "DetectMovesIntoLargerEdits"
    "FlattenDynamicContent"
    "IgnoreChangesToQuotationMarks"
    "IgnoreWhitespaceChanges"
    "IgnoreRunnersInChangedPagesOnly"
    "DeduplicateHeaderFooterChanges"
    "ShowChangesReport"
    ```

    **Formatting, style and comments**

    ```json expandable theme={null}
    "StyleChangesEnabled"
    "StyleChangeConfig"
    "CommentOption"
    "PreserveAcceptedComments"
    ```

    **Author of changes**

    ```json expandable theme={null}
    "DefaultAuthorOption"
    "DefaultAuthorCustomOptionValue"
    "DefaultAuthorLauncherDropdownVisible"
    "DefaultTrackChangesBehaviour"
    ```

    **Whole setting groups**

    Listing one of these names enforces every setting inside that group as a block. You cannot enforce an individual setting from within a group.

    ```json expandable theme={null}
    "RedlineMarkupScheme"
    "PowerPointRedlineSettings"
    "ExcelRedlineSettings"
    ```

    <Warning>
      **Names that no longer work.** Earlier revisions of this article listed the following. They are ignored if you list them today, so remove them from any existing base profile.

      | Name | Why it no longer applies | What to do instead |
      | - | - | - |
      | `CompareHeadersAndFooters` | Split into two separate settings. Only ever applied to version 1 profiles. | List `CompareHeaders` and `CompareFooters`. |
      | `SmallChangesLevel` | This is a stored value name, not a setting name. | List `ComparisonResolution`. |
      | `DefaultSummaryPagePosition` | Became a global setting in 26.6.0. | Configure the `SummaryPagePosition` registry value. |
      | `FilenameOutputFormat` | Became a global setting in 26.6.0. | Configure the `OutputFilenamePatternGlobal` registry value. |

      `DefaultViewMode`, `ThreePaneShowComments` and `StripPdfLineNumbers` also became global settings in 26.6.0 and cannot be enforced through a profile. See [Most common Draftable Legal registry configurations](/hc/en-us/articles/24732245077401-Most-common-Draftable-Legal-registry-configurations) for the global registry values that replaced them.
    </Warning>
  </Step>

  <Step>
    Using the information above, you can prepare your base profile JSON, and once you have your JSON profile ready, go to the Group Policy Editor and find the "Redline Settings Base Profile" item.

    <Frame>
      <img src="https://mintcdn.com/draftable/B2kzCCfUvVdHgQCw/images/draftable-legal/image-242.png?fit=max&auto=format&n=B2kzCCfUvVdHgQCw&q=85&s=2089b1d77b7d9b6805540c144236f7ab" alt="" width="1433" height="1013" data-path="images/draftable-legal/image-242.png" />
    </Frame>
  </Step>

  <Step>
    Within this policy, paste the entire JSON profile as a string, to use as a base template to add ***enforced*** Redline settings (i.e. to configure and lock the specific Redline setting across all profiles)

    <Frame>
      <img src="https://mintcdn.com/draftable/B2kzCCfUvVdHgQCw/images/draftable-legal/image-243.png?fit=max&auto=format&n=B2kzCCfUvVdHgQCw&q=85&s=abbefb0dd757dc171366fced53da9e8c" alt="" width="844" height="788" data-path="images/draftable-legal/image-243.png" />
    </Frame>

    <Note>**Note:** Enforcing does not allow for a setting to be locked, while still being configurable across different profiles. The enforced setting will be the same for all Profiles and will be based on the "Redline Settings Base Profile" entered in the above policy.</Note>
  </Step>
</Steps>

### How enforced settings appear to your users

An enforced setting is applied from your base profile every time profiles are loaded, so a change a user makes to one will not persist.

<Note>
  **Known display issue in 26.6.0 and later.** In the settings interface introduced in 26.6.0, enforced settings are not greyed out and do not show the "Set by your organisation" label. The setting is still enforced and the user's change will not be kept, but the interface does not signal the lock in advance. We are addressing this.

  If you are rolling out enforced settings, it is worth telling your users which settings are firm managed rather than relying on the interface to show them.
</Note>

<Tip>
  Rather than writing the JSON by hand, build and export a profile as described in [Getting the profile JSON ready](#getting-the-profile-json-ready) above, then add the `Enforced` array to the exported file.

  Exporting also keeps you on the current profile format. The example above is an older version 1 profile, kept because it still loads correctly. Profiles exported from 26.6.0 and later are version 3, and both formats accept the `Enforced` array in the same way.
</Tip>

### Disabling the Draftable Default profile 

Administrators can disable the Draftable Default profile by using the policy 'Admin Base Profiles Only' policy. 

<Steps>
  <Step>
    Open the Group Policy editor

    <Frame>
      <img src="https://mintcdn.com/draftable/B2kzCCfUvVdHgQCw/images/draftable-legal/image-244.png?fit=max&auto=format&n=B2kzCCfUvVdHgQCw&q=85&s=db9c2b2ee12897208bc2df78a35441e2" alt="" width="1427" height="1011" data-path="images/draftable-legal/image-244.png" />
    </Frame>
  </Step>

  <Step>
    Find the Admin Base Profiles Only policy

    <Frame>
      <img src="https://mintcdn.com/draftable/B2kzCCfUvVdHgQCw/images/draftable-legal/image-245.png?fit=max&auto=format&n=B2kzCCfUvVdHgQCw&q=85&s=1a27d3030ea522e1f0aababb60b8bc5c" alt="" width="745" height="699" data-path="images/draftable-legal/image-245.png" />
    </Frame>
  </Step>

  <Step>
    Set to **enabled** to remove the Draftable Default profile. Users will still be able to create new profiles but these will be based on the Admin profiles created, and they cannot import any user profiles.
  </Step>
</Steps>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.