​

Intro

You can create different navigation configurations for your Domo mobile apps, allowing app users to more quickly access the content most relevant to them. This is done through creating and customizing mobile app configurations. The Mobile Configuration feature is available for all organizations. If your organization doesn’t use Mobile Configuration, individuals can still personalize their individual app navigation. Need support? Check out our FAQ or contact your Domo account team.

---

• Required grants
• Access mobile app configuration settings
• Create a mobile configuration
• Customize a configuration
  • Manage app properties
  • Edit the Bottom Tab Bar (Navigation Toolbar)
  • Edit the Navigation Top Drawer
  • Only Show Company Icon
  • Allow Personalized Navigation Bar?
• Manage configuration permissions
• View all configuration versions
• View configuration history
• Apply a theme to your configuration
• Delete a configuration
• Switch between mobile app configurations
• Personalize your navigation
• FAQ

---

​

Required Grants

There are two available grants for mobile configuration:

• Edit Mobile App Configurations — This allows users to create, edit, and delete mobile app configurations to which they have access. Note: This grant does not allow the holder to grant permissions in a configuration. This grant is for non-admin users who need to make changes to mobile app configurations.
• (Admin-only) Manage All Mobile App Configurations — This allows admin-level users to create, edit, and delete all mobile app configurations.

​

Access Mobile App Configuration Settings

Access the mobile app configuration settings from Admin Settings. In Admin Settings under Content, select Mobile. In the App registry tab, you can view the mobile apps in your instance. Note: Most instance registries only contain the Domo and Domo Task Center apps (if you’re using Domo Task Center). Select the app you want to configure to view the Configurations pane.

​

Create a Mobile Configuration

1. Access the mobile app Configurations pane.
2. Select Add to open the Clone configuration modal.
   
   In the modal, give your new configuration a title and description, choose an icon to represent it, and select which existing configuration to base your clone on.
   
3. Select Create to open the Configuration Settings for your new configuration.

​

Customize a Configuration

1. Access the mobile app Configurations page.
2. Follow the steps to create a mobile configuration or select an existing configuration from the list to view the Configuration Settings.
3. In the Configuration Settings, you can update the configuration name, description, and icon.
   
4. In the left rail select Properties to manage the available properties. Learn about properties below.
   

​

Manage App Properties

There are four possible properties to manage (Bottom Tab Bar, Navigation top drawer section, Only show company icon, and Allow personalized navigation bar?). Selecting Edit for any of the properties opens that property in the Properties tab. The interactive preview allows you to test your property configuration, including available languages and dark mode. Select the All properties breadcrumb at the top of the pane to return to the properties list.

​

Edit the Bottom Tab Bar (Navigation Toolbar)

The Bottom Tab Bar (Navigation Toolbar) includes four icons and a More option. Selecting Edit for this property displays the list of current items in the Bottom Tab Bar. When you select an item, the Properties tab allows you to add information like an ID, title, description, and icon for the selected item. You can remove or reorder items in the list. To add an item, select Add and choose Domo Content (cards, App Studio apps, or dashboards) or Domo Services like Approvals and Search. Select Save after making your changes.

​

Edit the Navigation Top Drawer

The Navigation Top Drawer includes a list of as many items as you would like. Selecting Edit for this property displays the list of current items in the Navigation top drawer. When you select an item, the Properties tab allows you to add information like an ID, title, description, and icon for the selected item. You can remove or reorder items in the list. To add an item, select Add and choose Domo Content (cards, App Studio apps, or dashboards) or Domo Services like Approvals and Search. Select Save after making your changes.

​

Only Show Company Icon

Selecting Edit for this property displays a switch in the Properties tab. Enabling the switch removes the Domo icon from the navigation top drawer and preserves your branding, as displayed in these images.

​

Allow Personalized Navigation Bar?

Selecting Edit for this property displays a switch in the Properties tab. Enabling the switch allows end users to personalize their Bottom Tab Bar/navigation bar. Select Save after making your changes.

​

Manage Configuration Permissions

The Permissions pane allows you to assign individuals and groups to a particular configuration.

1. Access the mobile app Configurations pane.
2. Select a configuration to view its configuration settings.
3. Go to the Permissions pane.
4. Select Add to open the permissions modal.
   
5. Find a person or group and select them to add them to the permissions list and close the modal.
   
6. Back in the Permissions pane, choose whether the person or group can View or Modify the configuration.
   Note: When a person or group has been given permission to a configuration, that is the configuration they will see when using the Domo mobile app. They do not need to sign out and log back in to the app to view the new configuration.

7. Select Save to keep your changes.

You can delete or reorder the people/groups in the permissions list. Save your changes before navigating away from the Permissions pane.

​

View All Configuration Versions

1. Access the mobile app Configurations pane.
2. Choose a configuration from the list.
3. Go to the Versions pane. The Versions pane displays the version number, status, and creation date for each existing version.
   

Versions can have one of two statuses:

Status	Description
Draft	Before you push a configuration version to Shipping, you can make changes to it.
Shipping	You can’t edit configuration versions in Shipping status or push versions in Shipping status back to Draft. To make changes, you must clone the version to make a new version.

​

View Configuration History

Follow these steps to view the history for your app configuration.

1. Access a mobile app’s Configurations pane.
2. Go to the History pane.
3. Use the pills at the top of the history data to filter the list to relevant data.
   

​

Apply a Theme to Your Configuration

You can select from pre-built theme packages to apply to your mobile app configuration as in Brand Kit or App Studio.

1. Access the mobile app Configurations page.
2. From the Configurations pane, go to the Theme pane.
   
3. Use the Select a theme dropdown and choose an available theme package.
   
4. Select Save to apply your chosen theme.
   

​

Delete a Configuration

1. Access the mobile app Configurations settings.
2. Locate the configuration you want to delete.
3. Select Show menu (three horizontal dots icon) > Delete to remove the configuration.
   

​

Switch Between Mobile App Configurations

If you have permission to more than one mobile app configuration at a time, you can switch between them in your mobile app.

1. Open the mobile app.
2. Select More (three horizontal lines icon).
   
3. Scroll to the bottom of the many and select Switch Configuration.
   
4. Choose the configuration you want to use.
   

​

Personalize Your Navigation

Whether or not your organization uses mobile configuration, all users can personalize the navigation in their own mobile app. Follow the steps below.

1. In the Domo mobile app, select More (three horizontal lines icon).
   
2. Select Personalize nav bar.
   
3. From the personalization screen, you can select More (three horizontal dots icon) for a current navigation item to edit its name and icon or remove it from the navigation.
   
4. Use the handles (three horizontal lines icons) to drag and reorder items in the navigation.
   
5. Select Add (plus icon) to add items to the navigation using search or your saved favorites.
   
6. (Optional) Select Close (x icon) or Reset to default to discard your changes.
   
7. When finished, select Save (checkmark icon) to apply your changes to your personal app.
   

​

FAQ