SvcCatalogItemDef | Metadata API Developer Guide

File Suffix and Directory Location

SvcCatalogItemDef components have the suffix catalogItem and are stored in the svcCatalogItems folder.

Version

SvcCatalogItemDef components are available in API version 53.0 and later.

Fields

Field Name	Description
categories	Field Type SvcCatalogCategoryItem[] Description A list of catalog categories that contain this catalog item.
description	Field Type string Description Free-text description of the catalog item.
flow	Field Type string Description The screen flow associated with the catalog item.
image	Field Type string Description The developer name of a content document to be displayed in the Service Catalog for this item.
internalNotes	Field Type string Description Intended to describe what the catalog item should do and its implementation. That value is meant for other catalog builders.
isFeatured	Field Type boolean Description Determines if the catalog item is part of the featured catalog items.
isProtected	Field Type boolean Description An auto-generated value. This value currently has no impact.
masterLabel	Field Type string Description Required. The primary label for the catalog item record.
sharedTo	Field Type SharedTo Description Describes how the catalog item is shared across multiple catalog categories. SvcCatalogItemDef only supports sharing with groups.
status	Field Type PublishStatusType (enumeration of type string) Description Required. Displays the publishing status of a catalog item. Values are: `Deprecated` `Draft` `PendingChanges` `Published`

SvcCatalogCategoryItem

Represents the assignment of this service to a category within the Service Catalog.

Field Name	Description
isPrimaryCategory	Field Type boolean Description Determines if the catalog category (svcCatalogCategory) is the primary category for this catalog item. Exactly one category per SvcCatalogItemDef component must set this attribute to true.
sortOrder	Field Type int Description The position of the catalog item relative to other catalog items in the catalog category.
svcCatalogCategory	Field Type string Description Required. The catalog category the catalog item is assigned to.

Declarative Metadata Sample Definition

The following is an example of a SvcCatalogItemDef component.

1<?xml version="1.0" encoding="UTF-8"?>
2<SvcCatalogItemDef xmlns="http://soap.sforce.com/2006/04/metadata">
3    <categories>
4        <isPrimaryCategory>true</isPrimaryCategory>
5        <sortOrder>1</sortOrder>
6        <svcCatalogCategory>category_1639787736046_Hardware</svcCatalogCategory>
7    </categories>
8    <categories>
9        <isPrimaryCategory>false</isPrimaryCategory>
10        <sortOrder>1</sortOrder>
11        <svcCatalogCategory>category_1639787728370_NewHireEssentials</svcCatalogCategory>
12    </categories>
13    <description>Request a new Laptop from Technology Organization.</description>
14    <flow>item_1639788052216_NewLaptop</flow>
15    <image>requestLaptop</image>
16    <isFeatured>true</isFeatured>
17    <isProtected>false</isProtected>
18    <masterLabel>New Laptop</masterLabel>
19    <sharedTo/>
20    <status>Published</status>
21</SvcCatalogItemDef>

Wildcard Support in the Manifest File

This metadata type supports the wildcard character * (asterisk) in the package.xml manifest file. For information about using the manifest file, see Deploying and Retrieving Metadata with the Zip File.