What is the Page Menu?
The page menu is the main menu that will appear at the top of your app that contains a link to each one of your start pages. It will stay visible regardless of which page is being viewed.
The page menu is great for adding structure to your app. If you're managing multiple start pages, this menu will give your users an easy way to navigate between those pages.
Here's an example of a page menu for the CRM template when logged in as a Sales Manager:
Note The page menu is separate from the user menu in the top-right corner of the live app. For more information on the user menu, click here.
Manage the Page Menu
You can enable and disable the page menu at any time from your app settings. From the Builder, click on "gear" icon to the left of your app's name in the top left corner, and then select Layout & Colors.
Set page menu to "Yes" or "No" and click the "Save Settings" button:
Build the Page Menu
Since the page menu displays a link for each start page in your Live App, you can add a new link by adding a new page. Just click on the Pages section, and then the "+ADD" button in the left column.
As soon as you add the new page, it will be available as the last link in the page menu:
Knack Tip: Click here for more on pages.
Hide Individual Links
You may not want every page to be included in the menu. Each individual page can be controlled from the Settings tab of the specific page.
Simply toggle the "Include this page in the Page Menu" option. All start pages are included by default.
Knack Tip: Not seeing the page menu option in the Settings tab? Remember that the page menu only includes start pages, like the "login" page.
Hide the Page Menu from a Page
Aside from hiding the link from the page menu, you can do the opposite. Toggle the "Display the Page Menu when viewing this page" option, if you want to hide the page menu when navigating to a specific page.
Change the Order of the Links
The order of the menu is set by the order of the start pages in your pages list. To change that order you can drag a start page and drop it in a new order.
In this example, we move the Calendar page from the last spot in the page tree to the second spot. Users will now see the Calendar page listed second on the page menu when they access the Live App:
You can add icons to the page menu links by editing the Settings tab for each page. Click the add icon link and you will be able to choose an icon.
When selecting an icon, you can also edit the alignment.
Left: the icon will appear on the left side of the button text.
Right: the icon will appear on the right side of the button text.
You can group pages on the page menu into a dropdown menu. This helpful for consolidating related links in your page menu:
Add a Dropdown Menu
To create a new dropdown menu, navigate to the Pages section of the Builder and click the "+Add" button. This will open a new popup to add a new page or dropdown menu.
Next, select the "Dropdown Menu" tab. Here you can select which starting pages to include in the dropdown menu and give your menu a name.
Note A page may only belong to one dropdown menu.
Once you have entered a name and selected which pages to include in your menu, click the "Add new dropdown" button. This will add your dropdown menu to the page tree on the left side of the Builder.
Now your dropdown menu will be visible in page menu when viewing your Live App.
Manage Dropdown Menus
To add or remove pages from an existing dropdown menu, click on that menu in the pages tree to open the "Settings" for that menu.
From the settings, you can change the name and select which pages to include in the dropdown menu.
If you need to change the order of the pages in a dropdown menu, you need to remove the pages from the dropdown menu, drag to reorder the pages in the page tree and then re-add the pages to the dropdown menu.
Delete a Dropdown Menu
To delete a dropdown menu, click on the gear icon next to the menu in the page tree. Then select "Delete" and the dropdown menu will be removed from the page menu. Note, that deleting a dropdown menu will not delete pages from the app.
Use Page Menus in Your App
User Roles and the Page Menu
If your app is set up with user roles, you can set the page menu so that the page links will show based on the user roles.
This means that when a user logs in they will only see page links for pages that are accessible by a user role they are assigned to. They will also see page links for any pages that are not protected with a login.
For example, let's say you have one start page that only Sales Manager user roles can access, and another page that only Sales Rep user roles can access. When a Sales Manager logs in they will only be able to see a page link to that Sales Manager page (since they've been assigned that user role). They won't see the link to the Sales Rep page.
To enable/disable user-based page links, change the option from the Layout & Colors link in your app settings: