• Page Layouts
• Viewing Existing Page Layouts
• Creating and Editing Page Layouts
  • Page Design
  • Adding Widgets
• Advanced
• Applying Page Layouts
• Removing Page Layouts
  • Resetting Page Layouts
  • Deleting Page Layouts

Page Layouts

Page Layouts allow you to customize the arrangement and visibility of elements on some key RT pages, like the ticket display page and asset display page. This allows administrators to tailor the interface on each queue or catalog for specific lifecycles and user roles.

Viewing Existing Page Layouts

As a SuperUser, you can view existing page layouts at Admin > Page Layouts, selecting either Ticket or Asset.

Creating and Editing Page Layouts

To create a new custom layout, click Create in the page menu. A popup allows you to name the new page layout, select the type and page, and start from an existing layout, if desired.

When naming your page layout, keep in mind that you will be able to use the page layout on multiple queues or catalogs. While you may have a specific queue in mind, you might make the name a bit more general so it still makes sense if you end up using it on multiple queues.

Page Design

The page layout designer is similar to the layout pages for dashboards. Add rows, and for each row select the number of columns you want. RT uses the Bootstrap grid system, so the column numbers must add up to 12. When you add columns, RT will create equal-width columns, but you can change this to have columns of all different widths.

Adding Widgets

To add widgets, drag them from the Available Widgets column on the left and drop them in the columns on the right. Move them up and down in the list by dragging. Remove widgets by clicking the X.

Advanced

The Advanced page shows the raw JSON of the current page layout. You usually shouldn't need to make edits directly on the Advanced page. However, it can be helpful if you want to transfer a page layout from one RT system to another. You can copy the JSON from one system and paste it into the Advanced section of another.

Applying Page Layouts

After creating a new page layout, you can apply it to one or more queues or catalogs on the queue and catalog admin pages.

On the bottom of the queue basics page, you can set a page layout for the ticket create, display, and update pages.

For assets, you can set a page layout for create and display.

Removing Page Layouts

If a page layout is no longer being used or you just make a mistake, you can remove page layout definitions. Page layouts created via the web UI are stored in RT's database and they can also be loaded from configuration files. Depending on how a page layout was originally created, you might delete it completely or reset to an original version stored in a configuration file.

Resetting Page Layouts

Some page layouts are originally loaded from a configuration file. Then you might modify them using the RT web UI and save that new version. If you decide that you want to reset to the original version or if you want to get updates from a new version of the configuration file, you can reset a page layout to the version from the file.

Resetting to the file version deletes your customizations from the database. If you think you might want to save them, you could create a new page layout with a different name and clone it from the current page layout before resetting it.

If a page layout has a version in a configuration file, the Advanced page will show a button that will reset to the version in the file, deleting any customizations.

Deleting Page Layouts

Page layouts can be deleted from the Advanced page using the "Delete Page Layout" button. If the page layout is being used by a queue or catalog, you will need to remove it before deleting.