Skip to main content

         This documentation site is for previous versions. Visit our new documentation site for current releases.      

Adding items to the menu bar

Updated on March 3, 2022

Create an effective navigation experience in your mobile app by adding pages and actions to the menu bar. For example, you can add a custom profile page to the menu bar of your Expenses app so that users can conveniently access the screen with their basic contact information.

Before you begin: Create a mobile channel for your mobile app. For more information, see Setting up mobile apps.
  1. Open your mobile channel:
    1. In the navigation pane of App Studio, click Channels.
    2. In the Current channel interfaces section, click the tile that represents a mobile channel for your app.
  2. On the mobile channel page, on the Content tab, click the Navigation category.
  3. In the Navigation section, manage the items that appear on the menu bar of your mobile app:
    Note: The menu bar in your mobile app displays icons and labels for up to five items. When you add a sixth item, the fifth icon and label change to the More button that groups all subsequent items. If you add only one item, then the menu bar is not displayed at all.
    • To add a mobile list page, click Add itemsMobile list pages, and then select the list page that you want to display on the menu bar.
    • To add a user interface page, click Add itemsPages, and then select the page that you want to display on the menu bar.
    • To add an action, click Add itemsActions, and then select the action that you want to display on the menu bar.
    • To remove an item, click the Remove icon on the rightmost side of the row.
    • To reorder items on the menu bar, drag the items up or down the list.
    For example: To give your users an overview of their work items, you can enhance the menu bar with the Expense reports mobile list page that lists the submitted expense reports and their statuses. Additionally, you can improve the way users log out of the mobile app by adding the Log out action to the menu bar.
  4. Click Save.
Result: You can see the updated menu bar on the preview in your mobile channel. At run time, your mobile app displays the items that you added on the menu bar. When users tap the icon of an item, the app displays the content of the page on the screen or triggers an action.
For example:

Navigation of the menu bar for an expense reporting app
Configuration of a menu bar by adding pages or actions with a preview of the menu bar.
What to do next: Verify the changes to your mobile app with the Pega Mobile Preview app. For more information, see Previewing mobile apps.
  • Authoring mobile list pages

    Improve the responsiveness and load time of the user interface in your mobile app by displaying the content of your app as a mobile list page. This way you enhance your app with a native screen that has fluent transitions and a search bar in the header by default.

  • Authoring mobile case pages for Cosmos React apps

    Customize case pages in the low-code authoring environment to highlight the most relevant information in one, user-friendly mobile view. This way, you ensure that users can efficiently view and edit cases on their mobile devices.

  • Adding a search gadget for Theme Cosmos and UI Kit mobile apps

    Improve the usability of your mobile app by configuring and enabling the search functionality. You can guarantee more meaningful search results and increase search speed by limiting the scope of searches to specific case types.

  • Adding a floating action button

    Promote the most important action on a page by adding a floating action button to your mobile app. For example, you can add a floating action button that starts a case flow for creating a new expense report in your Expenses mobile app.

Have a question? Get answers now.

Visit the Support Center to ask questions, engage in discussions, share ideas, and help others.

Did you find this content helpful?

Want to help us improve this content?

We'd prefer it if you saw us at our best. is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us