About this task

Toolbars provide a quick way to trigger commonly performed tasks, such as printing a document or refreshing a view. A Toolbar button works by executing a formula when you select it from a toolbar. You can customize the toolbars provided with Domino Designer or create your own.

For more details on editing existing toolbars, see Toolbars: smart shortcuts in Notes Help.

Note: Toolbar buttons were known as SmartIcon buttons prior to Release 6.

To create a new toolbar button


  1. Choose File - Preferences - Toolbar Preferences from the menu bar.

    The Toolbar Preferences dialog box displays.

    Tip: You can also right-click a toolbar and select Toolbar Preferences from the pop-up menu.
  2. Select the Toolbars tab.
  3. To either:
    • Edit an existing toolbar, select it from the Available Toolbars list.
    • Create a new toolbar, click New Toolbar, enter a name in the text box and press ENTER.
  4. Select the Customize tab.

    The name of the toolbar you are editing or creating displays in the Toolbar to modify field.

  5. Add predefined Notes buttons to the toolbar by either:
    • Dragging and dropping buttons from the Available Buttons list to the Toolbar Contents pane.
    • Selecting a button (or buttons using the CNTRL key while selecting) and clicking Add to toolbar.
      Tip: You can change the display of the Available Buttons list to list them alphabetically by clicking Sort Buttons and selecting by Description.
  6. To create and add a new button, click New and select Button from the drop-down list.

    The Edit Toolbar Button dialog box displays.

  7. Enter a name for the button in the Button Text field and enter a description of the task the button performs in the Pop Up Help Text field.

    This text appears when a user mouses over the button.

  8. Add the formula that this button triggers in the Formula box.

    Click the Fields & Functions button to see a list of the fields, @functions, and @commands available for you to reference in the formula.

    Click the Formula Window button if you want a larger window in which to write and edit your formula.

  9. Click the Change Icon button and select an image from the Insert Image Resource dialog box.
    Tip: Supply an icon so that the button is visible to users. The default display style, which you can change on the Basics tab of the Toolbar Preferences dialog box, is Icon only. If this is selected, only icons display on the toolbar; button text does not.
  10. Click Save Toolbar, then click OK to close the Toolbar Preferences dialog box.


Toolbars are associated with each user's workspace; they are not associated with databases and are not shared among users. Toolbars are also specific to each client. A toolbar you customize in Designer does not display in the Notes client.

A Toolbar button's formula runs on the user's workstation.