Viewing and managing custom layouts

What's my plan?





All Suites

Professional, Enterprise, or Enterprise Plus









Support

Professional or Enterprise







Location: Admin Center > Workspaces > Agent tools > Layouts


Enterprise plans can have multiple layouts active at the same time for
different types of tickets. Professional plans can have only one active layout. See Plan requirements for custom layouts.
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

About custom layouts with layout builder
Creating custom layouts to improve agent workflow
Best practices for creating custom layouts



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.



Note: 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. You need to submit and reopen
the ticket before you see a custom layout applied.



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


Note: You must have an Enterprise plan to use the features described in this section.
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.



{
"@context": "https://schema.org",
"@type": "TechArticle",
"@id": "https://support.zendesk.com/hc/en-us/articles/5447837810714",
"url": "https://support.zendesk.com/hc/en-us/articles/5447837810714-Viewing-and-managing-custom-layouts",
"headline": "Viewing and managing custom layouts",
"description": "You can view, edit, set default, deactivate, delete, and assign custom ticket layouts to contextual workspaces to control the ticket interface appearance based on your plan type.",
"articleSection": "Ticket customization",
"datePublished": "2023-02-27T18:58:27+00:00",
"dateModified": "2025-09-05T23:28:01+00:00",
"inLanguage": "en-US",
"mainEntityOfPage": {
"@type": "WebPage",
"@id": "https://support.zendesk.com/hc/en-us/articles/5447837810714"
},
"author": {
"@type": "Organization",
"name": "Zendesk",
"@id": "https://www.zendesk.com"
},
"publisher": {
"@type": "Organization",
"name": "Zendesk",
"@id": "https://www.zendesk.com"
},
"isPartOf": {
"@type": "WebSite",
"name": "Zendesk Help",
"@id": "https://support.zendesk.com/hc/"
},
"about": {
"@type": "SoftwareApplication",
"name": "Zendesk",
"@id": "https://www.zendesk.com",
"softwareAddOn": {
"@type": "SoftwareApplication",
"name": "Copilot",
"@id": "https://support.zendesk.com/hc/en-us/sections/4405303717658"