# 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.

- Source: https://docs.ghlcustomercare.com/docs/mobile-and-desktop-app/mobile-app/custom-module-links-with-role-account-based-visibility
- Section: Mobile & Desktop App / Mobile App
- Reading time: 3 min
- Images: 7, each explained below
- Modified on Thu, 30 Apr at 12:17 PM

---
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?](#what-is-custom-module-links-with-role-and-account-based-visibility)[](#key-benefits-of-custom-module-links-with-role-and-account-based-visibility)
-   [Key Benefits of Custom Module Links with Role & Account-Based Visibility](#key-benefits-of-custom-module-links-with-role-and-account-based-visibility)[](#role-based-visibility)
-   [Role-Based Visibility](#role-based-visibility)[](#account-location-targeting)
-   [Account (Location) Targeting](#account-location-targeting)[](#unified-custom-module-configuration)
-   [Unified Custom Module Configuration](#unified-custom-module-configuration)[](#how-to-setup-custom-module-links-with-role-and-account-based-visibility)
-   [How To Setup Custom Module Links with Role & Account-Based Visibility](#how-to-setup-custom-module-links-with-role-and-account-based-visibility)[](#frequently-asked-questions)
-   [Frequently Asked Questions](#frequently-asked-questions)[](#related-articles)
-   [Related Articles](#related-articles)

---

# **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.

---

## **Key Benefits of Custom Module Links with Role & Account-Based Visibility**

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

---

## **How To Setup Custom Module Links with Role & Account-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](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155070336409/original/QnWpbjNHjx_hdf1AIKW4A0Fe8UgT48C_bw.png)

**Step 1 of 6: Navigate to Mobile App in your agency left pane**

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.
- Where to go: Navigate to Mobile App in your agency left pane.
- Next: Select Customize App to make the changes.

Full 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](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155070336760/original/Q6bTmmX6t2Um-q3A6iuUFLtBlNU_XEo_YA.png)

**Step 2 of 6: Select Customize App to make the changes**

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.
- What to choose: Select Customize App to make the changes.
- Next: Enter the Title, and URL

Full 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](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155070337001/original/cYQLvWKmICXk-H24D5v_4_505s4Ajyjoyw.png)

**Step 3 of 6: Enter the Title, and URL**

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.
- What to fill in: Enter the Title, and URL
- Next: Choose App Logo through Branding.

Full 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](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155070337145/original/hfkN2odlCZkeXD3AO6P8QvMhlY_DL4pjVw.png)

**Step 3 of 6: Enter the Title, and URL**

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.
- What to fill in: Enter the Title, and URL
- Next: Choose App Logo through Branding.

Full 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](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155070337248/original/uXe_MuS32ldUIN2hK3jNTVgKvnZ6DK1uvA.png)

**Step 4 of 6: Choose App Logo through Branding**

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.
- What to choose: Choose App Logo through Branding.
- Next: Click "Add New" to create new modules.

Full 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](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155070338058/original/zcy5cBhBIxCz2TQaB2RmBbFU1HgDJl2NKw.png)

**Step 5 of 6: Click "Add New" to create new modules**

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.
- What to click: Click "Add New" to create new modules.
- Next: Click Save

Full 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](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155070346350/original/Gxja9DqSx6KvKcKe9GLxzkqrYQMtfNbcbw.png)

**Step 5 of 6: Click "Add New" to create new modules**

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.
- What to click: Click "Add New" to create new modules.
- Next: Click Save

Full 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.

---

## **Related Articles**  

-   [Whitelabel Customizer Overview](https://docs.ghlcustomercare.com/docs/mobile-and-desktop-app/whitelabel-mobile-app/how-to-promote-and-customize-your-whitelabel-mobile-app-a-comprehensive-guide)
-   [User Roles and Permissions](https://docs.ghlcustomercare.com/docs/settings/user-settings/sub-account-user-roles-permissions-and-assigned-data) 
-   [Managing Accounts (Locations)](https://docs.ghlcustomercare.com/docs/settings/user-settings/how-to-create-a-user-or-admin-to-manage-multiple-hl-locations-without-giving-the)
-   [Menu Order Customization](https://docs.ghlcustomercare.com/docs/settings/agency-settings-2/customizing-ghl-customer-care-menus-a-guide-to-custom-menu-links)

---

Documentation for GHL Customer Care. Support: support@ghlcustomercare.com