Skip to content
Add-ons & Sales Trainings

White-Label Desktop App Setup Guide

Learn how to customize, build, and share a branded GHL Customer Care desktop app for macOS, Windows, and Linux using the Desktop App Customizer in Agency Dashboard.

6 min read1,434 words7 explained imagesUpdated Fri, 17 Jul at 12:12 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. What is the White-Label Desktop App?
  2. Key Benefits of the White-Label Desktop App
  3. Supported Platforms
  4. How To Setup the White-Label Desktop App
  5. Step 1: Open the Desktop App Customizer
  6. Step 2: Configure the Desktop App
  7. Step 3: Review the Live Preview
  8. Step 4: Save the Configuration
  9. Step 5: Submit the App for Build
  10. Step 6: Download, Copy, and Share Access Links
  11. Step 7: Promote the Published App to Sub-Accounts
  12. Using Desktop App Branding With a Whitelabel Domain
  13. Frequently Asked Questions
  14. Related Articles

GHL Customer Care’s White-Label Desktop App lets agencies create a branded desktop application experience for their customers across macOS, Windows, and Linux. Using the Desktop App Customizer in the Agency Dashboard, agencies can configure the app’s theme, icon, name, background image, and placeholder images before submitting the app for build. This gives agencies a more polished way to deliver a branded desktop experience without manually packaging applications.

TABLE OF CONTENTS

What is the White-Label Desktop App?

The White-Label Desktop App gives agencies a way to create and distribute a branded desktop application for their customers. Instead of relying only on the standard GHL Customer Care or LeadConnector desktop app experience, agencies can customize the desktop app’s visual identity so it better reflects their own brand.

The Desktop App Customizer is available from the Desktop App tab in the Agency Dashboard. Agencies can apply branding updates, preview the app in real time, submit the app for build, and then download the app or copy generated access links once the build is complete.

Note: The White-Label Desktop App is separate from the standard GHL Customer Care and LeadConnector desktop apps. Use it when you want to customize and distribute a branded desktop app for your customers. For the standard desktop app, see Download GHL Customer Care & LeadConnector Desktop App for Windows, macOS & Linux.

Key Benefits of the White-Label Desktop App

A branded desktop app helps agencies create a more consistent customer experience while giving users a focused way to access GHL Customer Care from their desktop. These benefits are especially useful for agencies that want their software experience to feel cohesive across login pages, apps, and customer onboarding materials.

  • Fully branded desktop experience: Agencies can customize the app name, app icon, theme, login screen title, subtitle, full logo, background image, and placeholder images to align the desktop app with their brand.
  • Cross-platform availability: Agencies can create branded desktop apps for macOS, Windows, and Linux.
  • Live preview before building: The Desktop App Customizer shows changes in real time so agencies can review the app’s look and feel before submitting it for build.
  • Automated builds: After the Build App action is triggered, GHL Customer Care starts the build process and generates application links when the build is complete.
  • Streamlined distribution: Agencies can download the completed app, copy its access links, or promote a published app directly to sub-account users through an in-app download
  • More focused desktop experience: A desktop app gives users a dedicated workspace outside the browser, helping reduce distractions and improve day-to-day workflow efficiency.

Supported Platforms

Platform availability determines which users can install and use the branded desktop app. Offering desktop app access across major operating systems helps agencies support customers using different devices and internal technology requirements.

The White-Label Desktop App is available across:

  • macOS
  • Windows
  • Linux

How To Setup the White-Label Desktop App

A clear setup process helps agencies review branding, submit the app correctly, and distribute the finished desktop app with confidence. Complete each step in order so the generated app reflects the intended branding before it is shared with customers.

Step 1: Open the Desktop App Customizer

Log in to your Agency Dashboard and open the Desktop App tab. This is where you can configure the White-Label Desktop App, review branding changes in the live preview, and submit the app for building.

Step 1: Open the Desktop App Customizer (image 1 of 7) What this shows Log in to your Agency Dashboard and open the Desktop App tab. What this shows Illustrates the "Step 1: Open the Desktop App Customizer" section of "White-Label Desktop App Setup Guide". This screenshot appears in the "Step 1: Open the Desktop App Customizer" section of "White-Label Desktop App Setup Guide". The text alongside this image reads: Log in to your Agency Dashboard and open the Desktop App tab. This is where you can configure the White-Label Desktop App, review branding changes in the live preview, and submit the app for building. Immediately after, the guide continues: Add the desktop app branding details you want customers to see. These settings control the app’s visual identity, login screen content, and brand presentation inside the White-Label Desktop App. Image 1 of 7 How to confirmLog in to your Agency Dashboard and open the Desktop App tab. This is where you can configure the White-Label Desktop App, review branding changes in the live preview, and submit the app for building. Next stepAdd the desktop app branding details you want customers to see. These settings control the app’s visual identity, login screen content, and brand presentation inside the White-Label Desktop App.

Step 2: Configure the Desktop App

Add the desktop app branding details you want customers to see. These settings control the app’s visual identity, login screen content, and brand presentation inside the White-Label Desktop App.

  • Theme: Choose a preset theme or create a custom theme for the White-Label Desktop App.
  • App Icon: Upload the app icon you want customers to see when using the desktop app.
  • App Name: Enter the app name shown in the title bar and sign-in button. The app name cannot be changed while the app is being built.
  • Title: Add the large heading that appears on the login screen.
  • Subtitle: Add the supporting text that appears below the title on the login screen.
  • App Full Logo: Upload the full logo for the app. The image is scaled to 512 x 128.
  • Background Image: Upload the background image for the desktop app experience.
  • Placeholder Images: Upload placeholder images to enhance the app’s appearance.
Step 2: Configure the Desktop App (image 2 of 7) What this shows Theme: Choose a preset theme or create a custom theme for the White-Label Desktop App. What this shows Illustrates the "Step 2: Configure the Desktop App" section of "White-Label Desktop App Setup Guide". This animation appears in the "Step 2: Configure the Desktop App" section of "White-Label Desktop App Setup Guide". The text alongside this image reads: Theme: Choose a preset theme or create a custom theme for the White-Label Desktop App. App Icon: Upload the app icon you want customers to see when using the desktop app. App Name: Enter the app name shown in the title bar and sign-in button. The app name cannot be changed while the app is being…. Immediately after, the guide continues: Review the live preview to confirm the desktop app reflects the selected branding settings. The preview updates as customizations are applied, allowing agencies to visualize the final app before submitting it for build. Image 2 of 7 What to fill inTheme: Choose a preset theme or create a custom theme for the White-Label Desktop App. App Icon: Upload the app icon you want customers to see when using the desktop app. App Name: Enter the app name shown in the title bar and sign-in button. The app name cannot be changed while the app is being built. Title: Add the large heading that appears on the login screen. Subtitle: Add the supporting text that appears below the title on the login screen. App Full Logo: Upload the full logo for the app. The image is scaled to 512 x 128. Background Image: Upload the background image for the desktop app experience. Placeholder Images: Upload placeholder images to enhance the app’s appearance. Next stepReview the live preview to confirm the desktop app reflects the selected branding settings. The preview updates as customizations are applied, allowing agencies to visualize the final app before submitting it for build.
All 8 steps in this procedure
  1. Theme: Choose a preset theme or create a custom theme for the White-Label Desktop App.
  2. App Icon: Upload the app icon you want customers to see when using the desktop app.
  3. App Name: Enter the app name shown in the title bar and sign-in button. The app name cannot be changed while the app is being built.
  4. Title: Add the large heading that appears on the login screen.
  5. Subtitle: Add the supporting text that appears below the title on the login screen.
  6. App Full Logo: Upload the full logo for the app. The image is scaled to 512 x 128.
  7. Background Image: Upload the background image for the desktop app experience.
  8. Placeholder Images: Upload placeholder images to enhance the app’s appearance.

Step 3: Review the Live Preview

Review the live preview to confirm the desktop app reflects the selected branding settings. The preview updates as customizations are applied, allowing agencies to visualize the final app before submitting it for build.

Step 3: Review the Live Preview (image 3 of 7) What this shows Review the live preview to confirm the desktop app reflects the selected branding settings. What this shows Illustrates the "Step 3: Review the Live Preview" section of "White-Label Desktop App Setup Guide". This screenshot appears in the "Step 3: Review the Live Preview" section of "White-Label Desktop App Setup Guide". The text alongside this image reads: Review the live preview to confirm the desktop app reflects the selected branding settings. The preview updates as customizations are applied, allowing agencies to visualize the final app before submitting it for build. Immediately after, the guide continues: Save the configuration once the branding settings are complete. Saving prepares the selected theme, app name, icon, title, subtitle, full logo, background image, and placeholder images for the build process. Image 3 of 7 How to confirmReview the live preview to confirm the desktop app reflects the selected branding settings. The preview updates as customizations are applied, allowing agencies to visualize the final app before submitting it for build. Next stepSave the configuration once the branding settings are complete. Saving prepares the selected theme, app name, icon, title, subtitle, full logo, background image, and placeholder images for the build process.

Step 4: Save the Configuration

Save the configuration once the branding settings are complete. Saving prepares the selected theme, app name, icon, title, subtitle, full logo, background image, and placeholder images for the build process.

Step 5: Submit the App for Build

After saving the configuration, submit the app for building. Once the Build App action is triggered, GHL Customer Care automatically starts the build process.

Step 5: Submit the App for Build (image 4 of 7) What this shows After saving the configuration, submit the app for building. What this shows Illustrates the "Step 5: Submit the App for Build" section of "White-Label Desktop App Setup Guide". This screenshot appears in the "Step 5: Submit the App for Build" section of "White-Label Desktop App Setup Guide". The text alongside this image reads: After saving the configuration, submit the app for building. Once the Build App action is triggered, GHL Customer Care automatically starts the build process. Immediately after, the guide continues: Once the build is complete, GHL Customer Care generates the corresponding application links. Agencies can download the app or copy the access links within the timeframe shown in GHL Customer Care, then share the appropriate links with users. Image 4 of 7 How to confirmAfter saving the configuration, submit the app for building. Once the Build App action is triggered, GHL Customer Care automatically starts the build process. Next stepOnce the build is complete, GHL Customer Care generates the corresponding application links. Agencies can download the app or copy the access links within the timeframe shown in GHL Customer Care, then share the appropriate links with users.

Once the build is complete, GHL Customer Care generates the corresponding application links. Agencies can download the app or copy the access links within the timeframe shown in GHL Customer Care, then share the appropriate links with users.

These links can be included in:

  • Onboarding materials
  • Client portals
  • Documentation
  • Customer support responses
Step 6: Download, Copy, and Share Access Links (image 5 of 7) What this shows Onboarding materials Client portals Documentation Customer support responses What this shows Illustrates the "Step 6: Download, Copy, and Share Access Links" section of "White-Label Desktop App Setup Guide". This screenshot appears in the "Step 6: Download, Copy, and Share Access Links" section of "White-Label Desktop App Setup Guide". The text alongside this image reads: Onboarding materials Client portals Documentation Customer support responses. This part of the guide covers 4 fields, listed below. Immediately after, the guide continues: After the app reaches the Published state, use the Promote toggle in the Desktop App Customizer to make the app available inside sub-accounts. Image 5 of 7 What this coversOnboarding materials Client portals Documentation Customer support responses
Fields in this part of the guide Onboarding materialsClient portalsDocumentationCustomer support responses
Next stepAfter the app reaches the Published state, use the Promote toggle in the Desktop App Customizer to make the app available inside sub-accounts.
All 4 steps in this procedure
  1. Onboarding materials
  2. Client portals
  3. Documentation
  4. Customer support responses

Step 7: Promote the Published App to Sub-Accounts 

After the app reaches the Published state, use the Promote toggle in the Desktop App Customizer to make the app available inside sub-accounts. 

Step 7: Promote the Published App to Sub-Accounts (image 6 of 7) What this shows After the app reaches the Published state, use the Promote toggle in the Desktop App Customizer to make the app available inside sub-accounts. What this shows Illustrates the "Step 7: Promote the Published App to Sub-Accounts" section of "White-Label Desktop App Setup Guide". This screenshot appears in the "Step 7: Promote the Published App to Sub-Accounts" section of "White-Label Desktop App Setup Guide". The text alongside this image reads: After the app reaches the Published state, use the Promote toggle in the Desktop App Customizer to make the app available inside sub-accounts. Immediately after, the guide continues: When promotion is enabled, sub-account users see a download banner for the agency’s White-Label Desktop App. Image 6 of 7 What to chooseAfter the app reaches the Published state, use the Promote toggle in the Desktop App Customizer to make the app available inside sub-accounts.
Buttons and menus referenced PublishedPromote
Next stepWhen promotion is enabled, sub-account users see a download banner for the agency’s White-Label Desktop App.

When promotion is enabled, sub-account users see a download banner for the agency’s White-Label Desktop App. 

Download links for the other supported operating systems remain available below the primary installer. All banner download links point to the latest published build.

The banner detects the user’s operating system and highlights the matching installer for:

- macOS 

- Windows 

- Linux

Step 7: Promote the Published App to Sub-Accounts (image 7 of 7) What this shows The banner detects the user’s operating system and highlights the matching installer for: What this shows Illustrates the "Step 7: Promote the Published App to Sub-Accounts" section of "White-Label Desktop App Setup Guide". This screenshot appears in the "Step 7: Promote the Published App to Sub-Accounts" section of "White-Label Desktop App Setup Guide". The text alongside this image reads: The banner detects the user’s operating system and highlights the matching installer for. Immediately after, the guide continues: Desktop app branding controls how the installed White-Label Desktop App looks, including the app name, icon, theme, logo, and login screen visuals. A whitelabel domain controls the branded web login URL customers use when accessing…. Image 7 of 7 What this coversThe banner detects the user’s operating system and highlights the matching installer for:
Buttons and menus referenced PublishedPromote
Next stepDesktop app branding controls how the installed White-Label Desktop App looks, including the app name, icon, theme, logo, and login screen visuals. A whitelabel domain controls the branded web login URL customers use when accessing GHL Customer Care through a browser.

Using Desktop App Branding With a Whitelabel Domain

Desktop app branding controls how the installed White-Label Desktop App looks, including the app name, icon, theme, logo, and login screen visuals. A whitelabel domain controls the branded web login URL customers use when accessing GHL Customer Care through a browser.

These settings are configured separately, but using both helps create a more consistent branded experience for customers. Use the Desktop App Customizer to brand the desktop app, and configure the whitelabel domain separately for the branded web login experience.

For setup instructions, see How to Set Up a Whitelabel Domain for the Desktop Web App.

Frequently Asked Questions

Q: Where do I find the Desktop App Customizer?
The Desktop App Customizer is available from the Desktop App tab in the Agency Dashboard.

Q: Which platforms are supported?
The White-Label Desktop App is available for macOS, Windows, and Linux.

Q: Can I preview the app before building it?
Yes. The Desktop App Customizer includes a live preview so you can review branding changes in real time before submitting the app for build.

Q: What happens after I click Build App?
GHL Customer Care automatically starts the build process. Once the build is complete, application links are generated and made available for access.

Q: How do I share the completed desktop app with users? 

After the app is built, you can download it or copy the generated access links from the Desktop App tab. After the app reaches the PUBLISHED state, you can also turn on the Promote toggle. This displays an app download banner inside sub-accounts. You can continue sharing direct links through onboarding emails, documentation, customer support responses, or client portals.

Q: Are Mac App Store and Microsoft Store listings available now?
The release note lists Mac App Store and Microsoft Store listing as a future enhancement. For now, use the generated download or access links provided after the build is complete.

Q: Is the whitelabel domain configured inside the Desktop App Customizer?
No. The Desktop App Customizer controls the desktop app’s branding and build settings. A whitelabel domain is configured separately for the branded desktop web app login experience.

Q: How does the download banner select an installer? 

The banner detects the sub-account user’s operating system and highlights the matching macOS, Windows, or Linux installer. Links for the other supported operating systems remain available below the highlighted installer.

Frequently asked questions

What is the White-Label Desktop App?
The White-Label Desktop App gives agencies a way to create and distribute a branded desktop application for their customers. Instead of relying only on the standard GHL Customer Care or LeadConnector desktop app experience, agencies can customize the desktop app’s visual identity so it better reflects their own brand. The Desktop Ap p Customizer is available from the Desktop App tab in the Agency Dashboard. Agencies can apply branding updates, previe w the app in real time, submit the app for build, and then download the app or copy generated access links once the build is complete. Note: The White-Label Desktop App is separate from the standard GHL Customer Care and LeadConnector desktop apps. Use it when you want to customize and distribute a branded desktop app for your customers. For the standard desktop app, see Download GHL Customer Care & LeadConnector Desktop App for Windows, macOS & Linux .

Was this guide helpful?

Related guides

How to Set Up a Whitelabel Domain for the Desktop Web App5 min read · 4 imagesGDPR Compliance and Data Privacy5 min readAdd-Ons (Formally Marketplace) Quick Reference Guide1 min read · 21 imagesProspect new clients with SaaS Audits1 min read · 12 images