Create a custom Service Catalog

Open the catalog workspace for a draft custom Asset Type and save its first approved entry.

Outcome: Select a draft custom Asset Type, add an approved catalog entry, and save the catalog.

For: Customer administrators and data model owners
Permission: update service_catalog
Time: 10–20 minutes
Changes made: Creates shared catalog data for a draft Asset Type

If you're stuck

  • Confirm the custom Asset Type is saved and still Draft.
  • Select the Asset Type before selecting Add.
  • Search the selected catalog for the same provider or manufacturer before adding another entry.

Before you start

  • Complete the draft Asset Type's sections, fields, dependencies, and catalog support.
  • Keep the Asset Type unpublished.
  • Gather the approved catalog names and source references.
  • Search for existing entries before adding a new one.

Field and option guide

UI itemPurposeWhat to select or enterWhere it appears later
Asset Type selectorChooses the catalog workspaceThe intended custom Asset Type with Draft statusCatalog heading and Asset fields
AddStarts one catalog recordSelect only after confirming the Asset TypeEntry form
Entry typeEstablishes the record's role in the hierarchyThe supported provider, manufacturer, model, module, software, specification, or attribute typeCatalog hierarchy and compatible Asset choices
NameIdentifies the entryCanonical approved name; avoid abbreviations that create duplicatesCatalog list and Asset selector
DescriptionExplains the entryShort identifying context; no credentials or secret dataEntry details
SaveStores the entrySubmit once after reviewing parent and typeSelected catalog after refresh

Start the catalog

  1. Open Administration → Service Catalog.
  2. Use the catalog selector to choose the draft custom Asset Type.
  3. Confirm the selected type is the intended draft.
Service Catalog workspace showing an example catalog, provider hierarchy, services, search, refresh, and add actions.
  1. Select Add.
  2. Choose the entry type required by the schema.
  3. Enter the canonical name and description.
  4. Add only approved specifications or attributes.
Add Provider form showing entry type, source, name, description, linked service type, version, and specifications.
  1. Select Save.

Expected result: The entry appears in the selected Asset Type's catalog after a refresh.

If the Asset Type is unavailable, confirm that it was saved as a customer draft and that your role includes Service Catalog access. A published custom type may no longer allow catalog editing.

Check your result

  1. Select Refresh.
  2. Re-select the draft Asset Type.
  3. Find the entry by its exact name.
  4. Open it and confirm the saved details.

Undo this change

Edit or remove an unused custom entry only while the draft lifecycle permits it and after checking dependencies and compatibility. Do not remove an entry already selected by test or customer assets without an impact review.

Learn and continue

Next steps

Get help

Email [email protected] and include:

  • Company, affected user, page URL, timestamp, and time zone
  • Draft Asset Type ID, catalog entry name, and entry type
  • Reproduction steps and the exact error

Never send passwords, credentials, tokens, or secret values.


Did this page help you?