Skip to content
Mobile & Desktop App

Custom Module Links with Role & Account-Based Visibility

Control custom module link visibility in GHL Customer Care using role-based and account-based targeting. Improve navigation, security, and user experience.

3 min read737 words7 explained imagesUpdated Thu, 30 Apr at 12:17 PM
View as markdownOpen in ClaudeOpen in ChatGPT
Each image has a one line explanation. Switch to full detail for the step it belongs to, the fields and buttons involved, examples and the whole procedure.
On this page
  1. Key Benefits of Custom Module Links with Role & Account-Based Visibility
  2. Role-Based Visibility
  3. Account (Location) Targeting
  4. Unified Custom Module Configuration
  5. How To Setup Custom Module Links with Role & Account-Based Visibility
  6. Frequently Asked Questions
  7. Related Articles

Custom Module Links in GHL Customer Care’s Whitelabel Customizer now offer advanced control over who can see specific navigation links and where they appear. By combining role-based visibility with account targeting, admins can create a cleaner, more relevant user experience while protecting sensitive resources. 


TABLE OF CONTENTS


What is Custom Module Links with Role & Account-Based Visibility?

Custom Module Links allow you to add external or internal links directly into your app’s navigation menu. With the introduction of role-based and account-based visibility, these links are no longer static—they can now be tailored to specific users and locations for a more controlled and personalized experience.

This enhancement enables admins to define whether a link should be visible to all users or restricted to admins, as well as limit its appearance to selected accounts (locations). As a result, navigation becomes more intentional, secure, and aligned with operational needs.


Understanding how this feature improves usability and control can help you better structure your app navigation and user experience.

  • Targeted Visibility: Display links only to specific users or roles, ensuring relevance and reducing clutter
  • Improved Security: Restrict sensitive or internal links to Admin users only
  • Account-Specific Customization: Tailor navigation experiences for different accounts or client locations
  • Controlled Rollouts: Test new links with a limited group before releasing them broadly
  • Centralized Configuration: Manage title, URL, icon, account selection, and visibility in one place

Role-Based Visibility

Role-based visibility determines which users can see a custom module link based on their assigned role. This ensures that only the appropriate users have access to certain navigation items, improving both usability and security.

  • All Users: The link is visible to all users within the selected accounts
  • Admin Only: The link is restricted to users with Admin-level access

Example Use Cases:

  • Internal dashboards visible only to admins
  • Training resources available to all team members

Account (Location) Targeting

Account targeting allows you to control where a custom module link appears by selecting specific accounts (locations). This ensures that only relevant users within those accounts see the link.

  • Select one or multiple accounts where the link should appear
  • Leave unselected accounts excluded from visibility

Example Use Cases:

  • Client-specific resources for individual locations
  • Region-based tools or integrations

Unified Custom Module Configuration

All settings for custom module links are now managed within a single Add/Edit Module popup. This unified interface simplifies the setup process and reduces the need for multiple configuration steps.

Within this popup, you can:

  • Enter the Title of the link
  • Add the URL destination
  • Choose an Icon for visual identification
  • Select Accounts (Locations)
  • Define Role-Based Visibility

Proper setup ensures that your custom links appear only where intended and are accessible to the right users, helping maintain a clean and secure navigation experience.

  1. Navigate to Mobile App in your agency left pane.
    Step 1 of 6: Navigate to Mobile App in your agency left pane What this shows Step 1 of 6: Navigate to Mobile App in your agency left pane. What this shows Shows where to go for step 1 of 6 in the "How To Setup Custom Module Links with Role & Account-Based Visibility" section of "Custom Module Links with Role & Account-Based Visibility". This screenshot accompanies step 1 of 6 in the "How To Setup Custom Module Links with Role & Account-Based Visibility" section of "Custom Module Links with Role & Account-Based Visibility". At this point in the walkthrough you navigate to Mobile App in your agency left pane. The next step is to select Customize App to make the changes. Step 1 of 6Image 1 of 7 Where to goNavigate to Mobile App in your agency left pane. Next stepSelect Customize App to make the changes.
    All 6 steps in this procedure
    1. Navigate to Mobile App in your agency left pane. this image
    2. Select Customize App to make the changes.
    3. Enter the Title, and URL
    4. Choose App Logo through Branding.
    5. Click "Add New" to create new modules.
    6. Click Save

  2. Select Customize App to make the changes.

    Step 2 of 6: Select Customize App to make the changes What this shows Step 2 of 6: Select Customize App to make the changes. What this shows Shows what to choose for step 2 of 6 in the "How To Setup Custom Module Links with Role & Account-Based Visibility" section of "Custom Module Links with Role & Account-Based Visibility". This screenshot accompanies step 2 of 6 in the "How To Setup Custom Module Links with Role & Account-Based Visibility" section of "Custom Module Links with Role & Account-Based Visibility". At this point in the walkthrough you select Customize App to make the changes. The next step is to enter the Title, and URL. Step 2 of 6Image 2 of 7 What to chooseSelect Customize App to make the changes. Next stepEnter the Title, and URL
    All 6 steps in this procedure
    1. Navigate to Mobile App in your agency left pane.
    2. Select Customize App to make the changes. this image
    3. Enter the Title, and URL
    4. Choose App Logo through Branding.
    5. Click "Add New" to create new modules.
    6. Click Save
  3. Enter the Title,  and URL

    Step 3 of 6: Enter the Title, and URL What this shows Step 3 of 6: Enter the Title, and URL What this shows Shows what to fill in for step 3 of 6 in the "How To Setup Custom Module Links with Role & Account-Based Visibility" section of "Custom Module Links with Role & Account-Based Visibility". This screenshot accompanies step 3 of 6 in the "How To Setup Custom Module Links with Role & Account-Based Visibility" section of "Custom Module Links with Role & Account-Based Visibility". At this point in the walkthrough you enter the Title, and URL. For context, this section explains: Proper setup ensures that your custom links appear only where intended and are accessible to the right users, helping maintain a clean and secure navigation experience. The next step is to choose App Logo through Branding. Step 3 of 6Image 3 of 7 What to fill inEnter the Title, and URL Next stepChoose App Logo through Branding.
    All 6 steps in this procedure
    1. Navigate to Mobile App in your agency left pane.
    2. Select Customize App to make the changes.
    3. Enter the Title, and URL this image
    4. Choose App Logo through Branding.
    5. Click "Add New" to create new modules.
    6. Click Save
    Step 3 of 6: Enter the Title, and URL What this shows Step 3 of 6: Enter the Title, and URL What this shows Shows what to fill in for step 3 of 6 in the "How To Setup Custom Module Links with Role & Account-Based Visibility" section of "Custom Module Links with Role & Account-Based Visibility". This screenshot accompanies step 3 of 6 in the "How To Setup Custom Module Links with Role & Account-Based Visibility" section of "Custom Module Links with Role & Account-Based Visibility". At this point in the walkthrough you enter the Title, and URL. For context, this section explains: Proper setup ensures that your custom links appear only where intended and are accessible to the right users, helping maintain a clean and secure navigation experience. The next step is to choose App Logo through Branding. Step 3 of 6Image 4 of 7 What to fill inEnter the Title, and URL Next stepChoose App Logo through Branding.
    All 6 steps in this procedure
    1. Navigate to Mobile App in your agency left pane.
    2. Select Customize App to make the changes.
    3. Enter the Title, and URL this image
    4. Choose App Logo through Branding.
    5. Click "Add New" to create new modules.
    6. Click Save
  4. Choose App Logo through Branding.

    Step 4 of 6: Choose App Logo through Branding What this shows Step 4 of 6: Choose App Logo through Branding. What this shows Shows what to choose for step 4 of 6 in the "How To Setup Custom Module Links with Role & Account-Based Visibility" section of "Custom Module Links with Role & Account-Based Visibility". This screenshot accompanies step 4 of 6 in the "How To Setup Custom Module Links with Role & Account-Based Visibility" section of "Custom Module Links with Role & Account-Based Visibility". At this point in the walkthrough you choose App Logo through Branding. For context, this section explains: Proper setup ensures that your custom links appear only where intended and are accessible to the right users, helping maintain a clean and secure navigation experience. The next step is to click "Add New" to create new modules. Step 4 of 6Image 5 of 7 What to chooseChoose App Logo through Branding. Next stepClick "Add New" to create new modules.
    All 6 steps in this procedure
    1. Navigate to Mobile App in your agency left pane.
    2. Select Customize App to make the changes.
    3. Enter the Title, and URL
    4. Choose App Logo through Branding. this image
    5. Click "Add New" to create new modules.
    6. Click Save
  5. Click "Add New" to create new modules.

    Step 5 of 6: Click "Add New" to create new modules What this shows Step 5 of 6: Click "Add New" to create new modules. What this shows Shows what to click for step 5 of 6 in the "How To Setup Custom Module Links with Role & Account-Based Visibility" section of "Custom Module Links with Role & Account-Based Visibility". This screenshot accompanies step 5 of 6 in the "How To Setup Custom Module Links with Role & Account-Based Visibility" section of "Custom Module Links with Role & Account-Based Visibility". At this point in the walkthrough you click "Add New" to create new modules. For context, this section explains: Proper setup ensures that your custom links appear only where intended and are accessible to the right users, helping maintain a clean and secure navigation experience. The next step is to click Save. Step 5 of 6Image 6 of 7 What to clickClick "Add New" to create new modules. Next stepClick Save
    All 6 steps in this procedure
    1. Navigate to Mobile App in your agency left pane.
    2. Select Customize App to make the changes.
    3. Enter the Title, and URL
    4. Choose App Logo through Branding.
    5. Click "Add New" to create new modules. this image
    6. Click Save
    Step 5 of 6: Click "Add New" to create new modules What this shows Step 5 of 6: Click "Add New" to create new modules. What this shows Shows what to click for step 5 of 6 in the "How To Setup Custom Module Links with Role & Account-Based Visibility" section of "Custom Module Links with Role & Account-Based Visibility". This screenshot accompanies step 5 of 6 in the "How To Setup Custom Module Links with Role & Account-Based Visibility" section of "Custom Module Links with Role & Account-Based Visibility". At this point in the walkthrough you click "Add New" to create new modules. For context, this section explains: Proper setup ensures that your custom links appear only where intended and are accessible to the right users, helping maintain a clean and secure navigation experience. The next step is to click Save. Step 5 of 6Image 7 of 7 What to clickClick "Add New" to create new modules. Next stepClick Save
    All 6 steps in this procedure
    1. Navigate to Mobile App in your agency left pane.
    2. Select Customize App to make the changes.
    3. Enter the Title, and URL
    4. Choose App Logo through Branding.
    5. Click "Add New" to create new modules. this image
    6. Click Save
  6. Click Save

Frequently Asked Questions

Q1: What happens if I don’t select any accounts?
If no accounts are selected, the link may not appear in any location. It’s recommended to explicitly choose the accounts where the link should be visible.

Q2: Can I assign visibility to roles other than Admin or All Users?
Currently, visibility is limited to All Users or Admin Only.

Q3: Can I edit visibility settings after creating a link?
Yes, you can update role visibility and account selection at any time by editing the custom module.

Q4: Will users be notified when new links are added?
No automatic notifications are sent. Users will see the link appear in their navigation based on the visibility settings.

Q5: Can I use this feature to hide links temporarily?
Yes, by adjusting account selection or role visibility, you can effectively control when and where links are visible.

Q6: Does this affect existing custom module links?
Existing links may need to be reviewed and updated to take advantage of the new visibility controls.


Was this guide helpful?

Related guides