Ticket layouts control the look and feel of the ticket interface. Admins can create multiple layouts and apply them to different types of tickets. See About custom layouts for more information. This article describes how you can view and manage custom layouts.
This article contains the following sections:
- Viewing custom layouts
- Editing layouts
- Setting the default layout
- Deactivating and deleting layouts
- Assigning a layout to a contextual workspace
Related articles
Viewing custom layouts
You can have up to 20 custom layouts in your account.
To view custom layouts
- In Admin Center, click
Workspaces in the sidebar, then select Agent tools > Layouts.
This page displays a list of layouts defined for your account. The list includes a standard layout for your account and any additional custom layouts that have been created.
The Default tag next to a layout shows which layout is currently set as the default for your account. A lock icon (
) next to a layout indicates the layout can't be edited.
From the list you can see and sort by the following information for each layout:
- Name: The name of the layout.
- Description: A brief description of the layout.
- Updated: Date the layout was last updated.
- Contextual workspaces (Enterprise only): The number of contextual workspaces that use the layout.
Tip: Click a number in the Contextual workspaces column to see a list of workspaces that use the layout. Click a contextual workspace name to open it.
Editing layouts
You can't edit the standard layout, but you can edit any other layout in the list. When you edit a layout, the changes apply to all tickets that use the layout. You’ll see the changes when you open or refresh a ticket.
To edit a layout
- In Admin Center, click
Workspaces in the sidebar, then select Agent tools > Layouts.
A list of layouts appears.
- Click the options menu icon (
) next to the layout you want to edit, then select Edit from the options menu.
The layout opens in layout builder.
- Click Customize layout, then update the layout as needed.
Alternatively, you can click a layout in the list. When the layout opens, click Customize layout.
See Creating custom layouts for details about the types of changes you can make to a layout. You can add or remove components in the layout. You can also move and resize components, or make changes to the context panel.
- When you’ve finished making layout changes, click Save.
Setting the default layout
Zendesk provides a standard ticket layout that is automatically treated as the default layout and applied to any ticket. You can replace this standard layout by creating a custom layout, then setting it as the default. While only one layout can be set as the global default, on Enterprise plans you can associate any active layout with one or more contextual workspaces.
To set the default layout
- In Admin Center, click
Workspaces in the sidebar, then select Agent tools > Layouts.
A list of layouts appears.
- Click the options menu icon (
) next to the layout you want to make the default, then select Edit.
The layout opens for editing.
- Click Set as default layout.
If you change the default layout, the new default is automatically applied to any contextual workspaces that reference the default.
Deactivating and deleting layouts
If you decide that you no longer need a layout, you can either "deactivate" it or delete it. You can deactivate a layout by making sure the layout is not set to be the default layout; and, on Enterprise plans, removing it from any contextual workspaces that were using the layout. Deactivated layouts remain in your list of layouts and can be reactivated if needed. Deleting a layout means that it's gone and can't be retrieved.
To deactivate a layout
- In Admin Center, click
Workspaces in the sidebar, then select Agent tools > Layouts.
- Locate the layout you want to deactivate.
- If the layout you want to deactivate was the default layout, pick another layout to use as the default.
- (Enterprise only) Make sure no contextual workspaces are assigned to the layout. If so,
assign another layout to the workspace. See Assigning a layout to a contextual workspace.
A deactivated layout remains in the layout list but it's not assigned to any contextual workspaces. You can reactivate it anytime by making it the default or assigning it to a contextual workspace.
To delete a layout
To permanently delete a layout, first make sure the layout is not being used as the default layout.
- In Admin Center, click
Workspaces in the sidebar, then select Agent tools > Layouts.
- Click the options menu icon (
) next to the layout you want to edit, then select Delete from the options menu.
- Click Delete to confirm the deletion.
The layout is deleted and removed from the layout list.
For Enterprise plans only:
If the layout is being used in a contextual workspace, you’ll receive a warning message before the layout is deleted.
When you delete a layout that’s being used in a contextual workspace, the workspace will revert to the layout that’s set as the active default.
If the layout you’re deleting is a custom layout that you’re using as the active default, the contextual workspace will revert to the Zendesk standard layout.
Assigning a layout to a contextual workspace
You can assign any layout to one or more contextual workspaces. This enables the workspace and the layout to work in conjunction to make sure your agents see the right ticket layouts at the right times. When you create or edit a contextual workspace, use the Layouts tab in the workspace editor to assign a custom layout. See Setting up contextual workspaces.
5 comments
Abbey O'Connor
Can you only use the layout if you apply it to a Contextual Workspace? I created a new one in my Sandbox, set it as the default, and then refreshed my support instance a few times and it's still not showing the updated layout. Is there a step I am missing?
0
Paolo
The rollout of this feature was completed last November 21, 2023. This should be enabled in your instance as of this writing. Please refer to this article for more information on Announcing custom layouts with layout builder.
If you are having trouble with the feature and it is not working as expected, I highly suggest reaching out to our Support Team to discuss this further: Contacting Zendesk Customer Support
Best,
Paolo | Technical Support Engineer | Zendesk
0
Youli
“When you first create a ticket, the standard ticket layout is used no matter what default layout or contextual workspace is configured for the ticket.”
Why? If I set a default layout I want that layout to apply to all my tickets including new created tickets. It's confusing to having new tickets looking different than old tickets. There's no reason for that!
1
Lisa Kelly
Youli, There are technical considerations that prevent us from applying a custom layout when you first create a ticket. As the article says, “ You need to submit and reopen the ticket before you see a custom layout applied.” If you have feedback or questions related to this feature, visit our community forum where we collect and manage customer product feedback.
0
Amelia Joughin
Hi! Is it possible to create a layout that will allow agents to be able to see the Views pane whilst they are working on a ticket? So they don't need to click out of the tickets to view the Views pane?
0