Toolbars
A toolbar gives a widget buttons, such as Close, Pin and Maximize, plus Color and Clear buttons for annotations. Some widgets need one: a web browser, for example, must be pinned before visitors can use it, and a Pin button lets them pin it.
A toolbar is a shared widget: you create it once, and any widget in any app can use it. Toolbars are listed in the Widget Library.
Add a toolbar to a widget
- Click Structures, select the app's structure, and select the widget.
- In the widget's Slots, open the drop-down list on Toolbar:
- To use an existing toolbar, choose it from the list. You are done.
- To make a new one, choose + Create new..., enter a name such as Pin and Close, and confirm.
- For a new toolbar, the Editor opens it in the Widget Library (Edit: Pin and Close). On Primary toolbar buttons (top), click Choose buttons….
- In the Buttons in Primary toolbar buttons (top) dialog, tick the buttons you want, for example Close button and Pin button, and click Apply.
- Click Save. The Editor attaches the toolbar to the widget and returns to the structure.
If you close the dialog with Cancel instead, the toolbar is still created and listed in the Widget Library, but the widget does not use it yet. Pick it from the widget's Toolbar list.
To change a toolbar later, click its row under the widget in the structure tree, or open it from the Widget Library. Changes apply to every widget that uses it.
To give every widget in an app the same toolbar, set Toolbar in the theme's Widget decorations defaults. See Themes.
Remove a toolbar a widget inherits
A widget without its own toolbar uses the one its theme gives it. The Toolbar list shows that inherited toolbar with the place it comes from, such as From Widget decorations. To show no toolbar on one widget, choose — None — in its Toolbar list. This works on a widget in a structure, on an item in a content set, and for a whole kind of widget on the Defaults page, for example Video viewer. An item's own Toolbar always replaces the inherited one; from MT Showcase 26.10.1 it no longer appears alongside it.

Toolbar buttons
| Button | What it does |
|---|---|
| Close button | Closes the widget. Visitors can also close a widget by dragging it off the screen. |
| Pin button | Pins or unpins the widget. A pinned widget cannot be moved or resized, and touches reach its content. |
| Maximize widget button | Expands the widget to fill the screen or, if one is set up, the nearest maximization area. When maximized, it becomes an Unmaximize button. |
| Annotation color button | Opens a palette of colors for annotations drawn on the widget, including an option for random colors. |
| Annotation clear button | Clears the annotations on the widget. Visitors press and hold it until the circular progress bar completes. |
| Mouse emulation button | Switches a web browser between touch input and emulated mouse input, for web pages that do not work well with touch. |
| Audience Upload button | Shows a QR code that visitors scan to upload a photo or video for moderation. Use it in the primary positions. See Collect and moderate audience uploads. |
A toolbar shows only toolbar buttons in its button positions, so nothing else can be put there. The editor refuses it when you drag another widget onto a button position, duplicate one that is already there, or add one from the Widget Library, and shows "Only toolbar buttons can go in a toolbar. Add a toolbar button instead." For a Group the message is "A Group cannot be used as a toolbar button. Add a toolbar button instead." A widget that is not a toolbar button and that an app saved in a button position with an older version still loads, and can be renamed or reordered there. The Choose buttons dialog lists it under Also in this slot. Move it out of the toolbar or delete it.

The annotation buttons act on the widget's annotations, so use them on widgets that have an Annotation decoration. See Annotations.

From the top: Close, Pin (it turns into Unpin while the widget is pinned), Maximize (Unmaximize while the widget is maximized), the annotation color button with its color palette and the random color option, and the Clear button, which shows a circular progress bar while you keep pressing it. The arrow at the bottom hides the secondary buttons and shows them again.
Button positions
A toolbar sits on the right-hand side of the widget and has three button positions:
- Primary toolbar buttons (top): always visible, at the top of the toolbar.
- Primary toolbar buttons (bottom): always visible, at the bottom of the toolbar.
- Secondary toolbar buttons: buttons that visitors can hide and show again with a toggle button on the toolbar.
Each position is optional. Fill each one with Choose buttons… as described above.

To move the whole toolbar away from its usual place at the widget's edge, set the toolbar's Position Offset, in pixels (x y). A negative x moves it left, over the widget; a positive y moves it down.
Toolbar of a maximized widget
In a maximization area the toolbar is a vertical bar on the left and right edge of the area, 370 px tall. If the area is shorter than 370 px, the buttons wrap into further columns that grow inward, over the maximized widget, and secondary buttons are shown in the same grid with no slide-out menu. A short and narrow area can therefore run out of room, so make the area at least 370 px tall where you can.
