Edit a catalog item in Catalog Builder
Make changes to an existing catalog item if you have permissions to edit the item.
Before you begin
- You can edit a catalog item if you are a catalog admin.
- If you have the catalog_builder_editor role and you are the owner of the catalog item, you can edit it. If the template access property, glide.sc.builder.template_access, is set to true (which is false by default), any user with the catalog_builder_editor role with access to the template used for creating the catalog item can edit the item.
- Role required: catalog_builder_editor, catalog_admin, or admin
About this task
When you edit a published item in the catalog builder, the system creates a draft copy of the item and its associated records such as variables, UI policies, and client scripts. The draft version is inactive until published. The published item remains in the published state and the Checked out field is set to True.
After you edit the item and submit it, the following scenarios are possible:
- When a pre-publish subflow isn't configured
- The edits to the draft version are merged with the associated published item.
- The draft item and the associated records are deleted.
- The Checked out field of the published item is set to False.
- When a pre-publish subflow is configured
- The state of the draft item is changed to In review.
- If the state variable of the subflow output returns Completed:
- The state of the draft item is changed to Reviewed and edits made to the draft version are merged with the associated published item.
- The state of the published item changes to Publishing, then to Published, and the Checked out field of the published item is set to False. The state change from Publishing to Published may not happen instantaneously.
- The reviewed draft item and the associated records are deleted.
- If the state variable of the subflow output returns Failed, the state of the draft item is reverted to Draft, and the item is ready for editing.
For information about configuring a review subflow, see Setting up the Catalog Builder.
Procedure
-
Navigate to All > Service Catalog > Catalog Builder.
-
Select the Catalog items tab.
Note: In the catalog item list view of the catalog builder, you can view items based on the value set in the glide.sc.builder.item_filter_mode property.
-
Select the item that you want to edit and select Edit.
Note:
- To edit an item in the In review state, you must cancel the review. After you cancel the review, the state of the item is reverted to Draft.
- To view the conversational details of the catalog item, select View conversational details. To edit an item in the In review state, you must cancel the review. After you cancel the review, the state if the item is reverted to Draft.
-
Make the required changes and select Save.
For information on editing a question and catalog item fields, see Edit a question in Catalog Builder and Create a catalog item using a template.
-
To make an item inactive, clear the Item is active check box in the Basic info section of the Details step.
-
To publish the modified item, navigate to the Review and submit step and select Submit.
- Add advanced capabilities to a catalog item
Add advanced capabilities, such as catalog client scripts, data lookup rules, and advanced reference qualifiers to a catalog item. - Create UI policies in Catalog Builder
Configure catalog UI policies with scripts and multiple catalog UI policy actions in Catalog Builder to facilitate the creation of complex catalog items. - UI policy form in Catalog Builder
Refer to the fields and their descriptions on the UI Policy form in Catalog Builder. - Create client script in Catalog Builder
You can create client scripts to customize the catalog item, such as to control the behavior of the catalog items after they're published. - Catalog client script form
Use client-side scripts to define dynamic behavior or validations on this catalog item. - Discard a catalog item
Discard a catalog item that’s in the Draft state in Catalog Builder.
Parent Topic:Creating or editing catalog item template
Related topics
View the conversational catalog overview dashboard using Catalog Builder
---
title: Edit a catalog item in Catalog Builder
description: Make changes to an existing catalog item if you have permissions to edit the item.
locale: en-US
canonical_url: https://www.servicenow.com/docs/r/australia/servicenow-platform/service-catalog/edit-cat-item-cat-builder.html
release: australia
product: Service Catalog
classification: service-catalog
topic_type: task
last_updated: "2026-09-10"
reading_time_minutes: 4
breadcrumb: [Creating or editing catalog item template, Catalog Builder, Service Catalog, Manage service capabilities, Extend ServiceNow AI Platform capabilities]
---
# Edit a catalog item in Catalog Builder
Make changes to an existing catalog item if you have permissions to edit the item.
## Before you begin
- You can edit a catalog item if you are a catalog admin.
- If you have the catalog\_builder\_editor role and you are the owner of the catalog item, you can edit it. If the template access property, **glide.sc.builder.template\_access**, is set to **true** \(which is **false** by default\), any user with the catalog\_builder\_editor role with access to the template used for creating the catalog item can edit the item.
- Role required: catalog\_builder\_editor, catalog\_admin, or admin
## About this task
When you edit a published item in the catalog builder, the system creates a draft copy of the item and its associated records such as variables, UI policies, and client scripts. The draft version is inactive until published. The published item remains in the published state and the **Checked out** field is set to **True**.
After you edit the item and submit it, the following scenarios are possible:
- **When a pre-publish subflow isn't configured**
- The edits to the draft version are merged with the associated published item.
- The draft item and the associated records are deleted.
- The **Checked out** field of the published item is set to **False**.
- **When a pre-publish subflow is configured**
- The state of the draft item is changed to **In review**.
- If the **state** variable of the subflow output returns **Completed**:
- The state of the draft item is changed to **Reviewed** and edits made to the draft version are merged with the associated published item.
- The state of the published item changes to **Publishing**, then to **Published**, and the **Checked out** field of the published item is set to **False**. The state change from **Publishing** to **Published** may not happen instantaneously.
- The reviewed draft item and the associated records are deleted.
- If the **state** variable of the subflow output returns **Failed**, the state of the draft item is reverted to **Draft**, and the item is ready for editing.
For information about configuring a review subflow, see [Setting up the Catalog Builder](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/servicenow-platform/service-catalog/set-up-cat-builder.md).
## Procedure
1. Navigate to **All** > **Service Catalog** > **Catalog Builder**.
2. Select the **Catalog items** tab.
**Note:** In the catalog item list view of the catalog builder, you can view items based on the value set in the **glide.sc.builder.item\_filter\_mode** property.
3. Select the item that you want to edit and select **Edit**.
**Note:**
- To edit an item in the **In review** state, you must cancel the review. After you cancel the review, the state of the item is reverted to **Draft**.
- To view the conversational details of the catalog item, select **View conversational details**.
To edit an item in the **In review** state, you must cancel the review. After you cancel the review, the state if the item is reverted to **Draft**.
4. Make the required changes and select **Save**.
For information on editing a question and catalog item fields, see [Edit a question in Catalog Builder](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/servicenow-platform/service-catalog/edit-question-cat-builder.md) and [Create a catalog item using a template](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/servicenow-platform/service-catalog/create-item-cat-builder.md).
5. To make an item inactive, clear the **Item is active** check box in the **Basic info** section of the **Details** step.
6. To publish the modified item, navigate to the **Review and submit** step and select **Submit**.
- **[Add advanced capabilities to a catalog item](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/servicenow-platform/service-catalog/add-advanced-capabilities.md)**
Add advanced capabilities, such as catalog client scripts, data lookup rules, and advanced reference qualifiers to a catalog item.
- **[Create UI policies in Catalog Builder](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/servicenow-platform/service-catalog/create-ui-policies-in-catalog-builder.md)**
Configure catalog UI policies with scripts and multiple catalog UI policy actions in Catalog Builder to facilitate the creation of complex catalog items.
- **[UI policy form in Catalog Builder](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/servicenow-platform/service-catalog/ui-policy-form-in-catalog-builder.md)**
Refer to the fields and their descriptions on the UI Policy form in Catalog Builder.
- **[Create client script in Catalog Builder](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/servicenow-platform/service-catalog/create-client-scripts-in-catalog-builder.md)**
You can create client scripts to customize the catalog item, such as to control the behavior of the catalog items after they're published.
- **[Catalog client script form](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/servicenow-platform/service-catalog/client-script-form.md)**
Use client-side scripts to define dynamic behavior or validations on this catalog item.
- **[Discard a catalog item](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/servicenow-platform/service-catalog/discard-a-catalog-item.md)**
Discard a catalog item that’s in the Draft state in Catalog Builder.
**Parent Topic:**[Creating or editing catalog item template](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/servicenow-platform/service-catalog/create-cat-item-template-cat-builder.md)
**Related topics**
[View the conversational catalog overview dashboard using Catalog Builder](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/servicenow-platform/service-catalog/using-catalog-conversational-experience.md)
| title | Edit a catalog item in Catalog Builder |
| description | Make changes to an existing catalog item if you have permissions to edit the item. |
| locale | en-US |
| canonical_url | https://www.servicenow.com/docs/r/australia/servicenow-platform/service-catalog/edit-cat-item-cat-builder.html |
| release | australia |
| product | Service Catalog |
| classification | service-catalog |
| topic_type | task |
| last_updated | 2026-09-10 |
| reading_time_minutes | 4 |
| breadcrumb | Creating or editing catalog item templateCatalog BuilderService CatalogManage service capabilitiesExtend ServiceNow AI Platform capabilities |