---
title: Toolbars
slug: toolbars
docTags: 
createdAt: 2025-06-11T20:26:17.824Z
---

Most Activate objects in additional to properties forms also have an associated tool bar.

The properties form is used display a list of actions that can be performed for the object.

There are a number of different tool bars that are displayed at different times.



|                   |                                                                                                                                                                                     |
| ---------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Name**               | **Description**                                                                                                                                                                     |
| Web.Properties.Toolbar | This toolbar is displayed at the top of the Properties form for the object. It should consist of actions that can be performed for the current object.                              |
| Web.Toolbar            | This toolbar is displayed at the top of the browse object page as the user is navigating the object hierarchy. This is normally used to display options like creating a new object. |

Figure 1: Example of Web.Properties.Toolbar

## Changing Toolbars and Adding additional items

Multiple \*.Toolbar paramters are supported and the best way to add additional items to a toolbar is to create a new toolbar parameter. Overriding and changing existing toolbars should be minimized as it makes upgrading more difficult.

Toolbars are stored in the system and normal Web Forms. However, they should only contain a top level RibbonPanel object with RibbonGroup and RibbonButton objects. The following diagram shows how these are made up.

 

### Ribbon Groups

Ribbon Groups are used to group RibbonButtons togeather and provide a logical grouping to make it easier for users to view.

|              |                                              |
| ----------------- | -------------------------------------------- |
| **Property Name** | **Description**                              |
| Text              | The text to display as the name of the group |

###  

### Ribbon Buttons

Ribbon Buttons are the main mechanism for allowing users to perform actions. Ribbon Buttons have the following main properties



|              |                                                            |
| ----------------- | ---------------------------------------------------------- |
| **Property Name** | **Description**                                            |
| Text              | The text to display for the button.                        |
| ImageURL          | The image to display for the button                        |
| Link              | The object that is being referenced by the button.         |
| Task              | The task to perform for the object referenced by the Link. |

The full options for all Menu Buttons are detailed here:  [Menu Buttons](docId\:z21XgLJkxCowEhZaD3ru6)