Create a PaCE policy version

---
title: Create a PaCE policy version
description: Create a version from scratch at any time for any of your existing PaCE policies.
locale: en-US
canonical_url: https://www.servicenow.com/docs/r/servicenow-platform/policy-as-code-engine-pace/pace-create-policy-version.html
release: brazil
product: Policy as Code Engine \(PaCE\)
classification: policy-as-code-engine-pace
topic_type: task
last_updated: "2026-09-10"
reading_time_minutes: 2
breadcrumb: [Create PaCE policy versions, Manage PaCE policy versions, Administer PaCE policies, Policy as Code Engine \(PaCE\), Extend ServiceNow AI Platform capabilities]
---

# Create a PaCE policy version

Create a version from scratch at any time for any of your existing PaCE policies.

## Before you begin

Role required: sn\_pace.code\_editor

## About this task

**Note:** Your administrator may have pre-configured policy versions that contain default caller and mapping inputs. You may not be able to edit these input variables, but you can add new inputs, as required.

## Procedure

1.  Navigate to **All** > **Policies** > **My Policies**.

    **Note:** To view all policies generated by admin/other users, navigate to **Policies** > **All Policies**.

2.  Click the policy name for the policy that you want to add a new version to.

3.  You can create a new version two different ways:

    -   Select the **Policy builder** tab, then the Overflow menu icon\[Omitted image "pace-overflow-icon.jpg"\] Alt text: Overflow menu icon.
    -   Select the **Version management** tab then **Create new version**.
4.  Select **Create new version**.\[Omitted image "pace-new-version-2.jpg"\] Alt text: Create new version in Policy builder tab.

    \[Omitted image "pace-new-versions-manage.jpg"\] Alt text: Create new version in Version management tab.

5.  Select the New blank version tile or an existing policy template, then **Create**.

    Templates can be filtered by most used, alphabetically, state, and type. By default, inactive templates are hidden.

6.  Clear the **Is low code** check box.

7.  In the Create New Policy Version form, add a description in the **Description** field.

    **Note:** The **Description** field is the only editable field in the form. The version and revision numbering cannot be modified and are automatically assigned.

8.  Click **Save**.


## What to do next

The policy version is saved and the version is assigned a number according to policy numbering. You can:

-   Define API Variables, Config Parameters, and Record References.

    See [Passing parameters to PaCE policies](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/servicenow-platform/policy-as-code-engine-pace/pace-passing-parameters.md).

-   Modify the policy script.

    See [Edit a PaCE policy script](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/servicenow-platform/policy-as-code-engine-pace/pace-edit-policy-script.md).

-   Test your policy version to ensure it is compliant.

    See [Use the Test Playground for PaCE policies](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/servicenow-platform/policy-as-code-engine-pace/pace-use-test-playground.md) for details.

-   Publish the policy version.

    See [Publish a PaCE policy version](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/servicenow-platform/policy-as-code-engine-pace/pace-publish-policy-version.md).

-   Review execution activity for the version.

    See [Review executed policy activity](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/servicenow-platform/policy-as-code-engine-pace/pace-review-executed-policies.md).

-   Delete the version.

    See [Delete a PaCE policy version](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/servicenow-platform/policy-as-code-engine-pace/pace-delete-policy-version.md).