Skip to content
Release: Australia · Updated: 2026-03-12 · Official documentation · View source

Create a renderer

Create or modify renderers using UI macros to provide the rendering instructions. Renderers define a specific look and feel for a catalog or category.

Before you begin

Role required: catalog_admin or admin

About this task

Use renderers to specify the following formats:

  • How catalogs appear on the multi-catalog homepage.
  • How categories appear on a catalog homepage.

For example, you can create a renderer showing the category homepage image, the description, and the first two catalog items in a category.

Procedure

  1. Create a UI macro to define specific rendering instructions.

  2. Navigate to Service Catalog > Catalog Definition > Renderers.

  3. Click New.

  4. Select to create a catalog or category renderer.

  5. Enter the renderer details.

FieldDescription
NameA name for the renderer.
MacroThe UI Macro to use.
Render catalog titleAppears for catalogs renderers. A check box to display the catalog title bar on the multi-catalog homepage.
Render titleAppears for category renderers. A check box to display the category title bar on the catalog homepage.Note: The admin and catalog_admin roles can view the Render title even when the check box is not selected.
Image omitted: ServiceCatalogRenderers.png
Screenshot for catalog renderers
  1. Click Submit.

    Note: To modify a default catalog or category renderer, follow a similar process, by selecting one of the default renderers listed.

    This new renderer is added to the list of available choices when applying a renderer.

Parent Topic:Service catalog home page configuration

Select a renderer for a catalog

Select a renderer and apply them to a catalog to change its appearance.

Before you begin

Role required: catalog_admin or admin

About this task

The following default catalog renderer schemes are available:

  • All Details: shows desktop image, title, and categories.
  • Image Only: shows desktop image only.
  • Title and Image: shows title and desktop image.
  • Title Only: shows title only.

Procedure

  1. Navigate to All > Service Catalog > Catalogs.

  2. Click the add content icon (+) on the upper right.

  3. Select a catalog in the middle panel of the pop-up window.

Image omitted: ServiceCatalogMultiCatalogHomePageArrange.png
4. Select a renderer from the list displayed in the right-hand panel, for example **Title Only**.
  1. Click Close to save the catalog with the renderer settings you defined.

Select a renderer for a category

Select a renderer scheme for your categories.

Before you begin

Role required: catalog_admin or admin

About this task

The following default category renderer schemes are available:

  • Category Items: shows desktop image, title, and description.
  • Category Items No Title: shows desktop Image and description.
  • Category Details: shows the subcategories and items in that category.

Procedure

  1. Navigate to All > Service Catalog > Catalog.

  2. Click the add content icon (+) on the upper right.

  3. Select a category in the middle panel of the pop-up window.

  4. Select a renderer from the list displayed in the right-hand panel, for example Category Items.

  5. Click the close icon (x) to save the catalog with the selected renderer.