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

Customizing the Playbook Experience

Customize the layout of your Playbook Experience with base system modular components, templates, and more via integrated UI Builder functionality.

Build custom experiences for your agents and fulfillers with the modular components in the Playbook Experience apps. To speed up the development process, add the Custom Layout UI Controller to pages where you want presets to auto-populate inputs for the provided components.

Note: You can also create your own custom components with UI Builder, but presets cannot auto-populate custom components with data.

Components

Determine how to display these modular components in your Playbook Experience:

  • Playbook stage picker

    The stages of a playbook can be displayed horizontally or vertically:

    • The vertical orientation shows:

      • All playbooks for a parent record,
      • The stages of each playbook,
      • How many activities remain to be completed in each stage, and
      • How many activities are in progress for each stage. In this example, a playbook named Playbook Experience Demo with stages named Assign, Create, Review and Update is shown. The Assign stage has 2 activities left to complete, with 1 in progress. The Create and Review and Update stages don't have blue numbers next to them, so they don't have any activities that are in progress.
Image omitted: playbook-vert-stages.png
Vertical view of a playbook named Playbook Experience Demo with stages named Assign, Create, Review and Update.
-   The horizontal orientation only shows the stages of a selected playbook. To see the activities of a stage, select the stage.
Image omitted: playbook-horizontal-stages.png
Horizontal view of a playbook named Playbook Experience Demo with stages named Assign, Create, Review and Update.
    Playbooks with more than 5 stages paginate.

    **Note:** The horizontal stage picker only shows you the playbook you are in and its stages, so you can’t navigate between playbooks unless you:

    -   Use a playbook template, or
    -   Create your own drop-down component with UI Builder.
    All playbook templates include a drop-down component to navigate between playbooks, and is auto-populated when you select the **Playbook Picker** preset.
  • Playbook activity picker

    The activity picker is where you navigate between activities.

    If you're using the vertical stage picker, turning on the activity picker means each stage can be expanded to shows its activities.

Image omitted: playbook-activity-picker-vert.png
Activity picker when you're viewing stages vertically.
If you're using the horizontal stage picker, turning on the activity picker allows you to expand or collapse the entire list of activities for the stage you're in.
Image omitted: playbook-activity-picker-horizon.png
Activity picker when you're viewing stages horizontally.
You can toggle the **Show Stages flag** on or off.
  • Playbook activity viewer

    The activity viewer is where you manage a stage's activities. You can change the way activities are displayed in this space:

    • The Stacked view displays all activities in a stage stacked on top of each other.
Image omitted: playbook-stacked-view.png
Activities stacked for the Assign stage. The 1st activity is complete, the 2nd is in progress and can be marked complete or skipped, and the 3rd is pending.
-   The **Focused** view displays a single selected activity.
Image omitted: playbook-focused-view.png
A single activity that you can mark as complete or skip.
-   The **Guided** layout
-   The **Wizard** layout
  • Playbook modals

    If you want the ability to cancel playbooks and add optional activities, you must add the Playbook Modals component to your pages. If you use a template, this is already included.

Image omitted: playbook-cancel-modular-modal.png
The Cancel playbook modal
Image omitted: playbook-opt-activity-modal.png
The Add optional activity modal

To start setting up components for your customized Playbook Experience, see Customize a playbook in UI Builder.

Provided UI Builder Bundles

If adding each component individually isn't ideal, you can also add an entire layout to a new or existing UI Builder template.

  • Focused Vertical
  • Stacked Vertical
  • Stacked Horizontal
  • Guided Layout
  • Horizontal Wizard
  • Focused Horizontal

Each layout contains the following components:

  • UI controller
  • Presets
  • Activity viewer
  • Activity picker
  • Modals
  • Playbook picker
  • Stage picker
  • Client scripts

To add a bundle to an existing or new UI Builder page, see Add a custom layout bundle to a UI Builder page. If you're creating a new experience and want to add a bundle to a standard record page, see Add a custom layout bundle to a UI Builder standard record page.