---
sourceDocument: Xanadu API Reference
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - en-US

ft:publication_title :

    - Xanadu API Reference

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# CatalogItemVariable - Scoped

# CatalogItemVariable - Scoped {#ariaid-title1}

* Release version: Xanadu
* 
* Updated August 1, 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 minute to read

The CatalogItemVariable API provides methods that enable you to create and modify service catalog item variables using scripts.

This API runs in the `sn_sc` namespace.

## CatalogItemVariable - create(Boolean standardUpdate) {#ariaid-title2}

Inserts the specified catalog item variable.
{#r_CatalogItemVariable-create_Boolean__table_s3d_zrd_ns__entry__3}

| Name | Type | Description |
|-|-|-|
| standardUpdate | Boolean | Flag that indicates whether to enable the running of engines and workflow. Valid values: * true: Enable engines and workflow. * false: Do not enable engines and workflow. {#r_CatalogItemVariable-create_Boolean__ul_nnx_xwn_kpb} |
[Table 1. Parameters]

{#r_CatalogItemVariable-create_Boolean__table_s3d_zrd_ns} {#r_CatalogItemVariable-create_Boolean__table_t3d_zrd_ns__entry__2}

| Type | Description |
|-|-|
| String | Return the sys_id of the inserted variable record. |
[Table 2. Returns]

{#r_CatalogItemVariable-create_Boolean__table_t3d_zrd_ns}

## CatalogItemVariable - deleteRecord(Boolean standardUpdate) {#ariaid-title3}

Deletes the defined catalog item variable.
{#r_CatalogItemVariable-deleteRecord_Boolean__table_p1l_4sd_ns__entry__3}

| Name | Type | Description |
|-|-|-|
| standardUpdate | Boolean | Flag that indicates whether to enable the running of engines and workflow. Valid values: * true: Enable engines and workflow. * false: Do not enable engines and workflow. {#r_CatalogItemVariable-deleteRecord_Boolean__ul_nnx_xwn_kpb} |
[Table 3. Parameters]

{#r_CatalogItemVariable-deleteRecord_Boolean__table_p1l_4sd_ns} {#r_CatalogItemVariable-deleteRecord_Boolean__table_q1l_4sd_ns__entry__2}

| Type | Description |
|-|-|
| void |   |
[Table 4. Returns]

{#r_CatalogItemVariable-deleteRecord_Boolean__table_q1l_4sd_ns}

## CatalogItemVariable - read(Object columns, Boolean standardUpdate) {#ariaid-title4}

Returns a mapping of catalog item variable attribute values.
{#r_CatalogItemVariable-read_Object_Boolean__table_j5k_5sd_ns__entry__3}

| Name | Type | Description |
|-|-|-|
| columns | Object | Set of columns for which to return values. |
| standardUpdate | Boolean | Flag that indicates whether to enable the running of engines and workflow. Valid values: * true: Enable engines and workflow. * false: Do not enable engines and workflow. {#r_CatalogItemVariable-read_Object_Boolean__ul_nnx_xwn_kpb} |
[Table 5. Parameters]

{#r_CatalogItemVariable-read_Object_Boolean__table_j5k_5sd_ns} {#r_CatalogItemVariable-read_Object_Boolean__table_k5k_5sd_ns__entry__2}

| Type | Description |
|-|-|
| Object | An object mapping column names to values. |
[Table 6. Returns]

{#r_CatalogItemVariable-read_Object_Boolean__table_k5k_5sd_ns}

## CatalogItemVariable - setAttributes(Object attributes) {#ariaid-title5}

Defines attribute values for this catalog item variable.
{#r_CatalogItemVariable-setAttributes_Object__table_twv_dtd_ns__entry__3}

| Name | Type | Description |
|-|-|-|
| attributes | Object | An object mapping column names to values. |
[Table 7. Parameters]

{#r_CatalogItemVariable-setAttributes_Object__table_twv_dtd_ns} {#r_CatalogItemVariable-setAttributes_Object__table_uwv_dtd_ns__entry__2}

| Type | Description |
|-|-|
| void |   |
[Table 8. Returns]

{#r_CatalogItemVariable-setAttributes_Object__table_uwv_dtd_ns}

## CatalogItemVariable - update(Object columnValues, Boolean standardUpdate) {#ariaid-title6}

Updates current catalog item variable with set values.
{#r_CatalogItemVariable-update_Object_Boolean__table_jxv_4td_ns__entry__3}

| Name | Type | Description |
|-|-|-|
| columnValues | Object | An object mapping column names to values. |
| standardUpdate | Boolean | Flag that indicates whether to enable the running of engines and workflow. Valid values: * true: Enable engines and workflow. * false: Do not enable engines and workflow. {#r_CatalogItemVariable-update_Object_Boolean__ul_nnx_xwn_kpb} |
[Table 9. Parameters]

{#r_CatalogItemVariable-update_Object_Boolean__table_jxv_4td_ns} {#r_CatalogItemVariable-update_Object_Boolean__table_kxv_4td_ns__entry__2}

| Type | Description |
|-|-|
| void |   |
[Table 10. Returns]

{#r_CatalogItemVariable-update_Object_Boolean__table_kxv_4td_ns}