White Label Setup Guide

White labelling lets you replace myCRMSIM branding with your own logo, colors, domain, and browser tab title. Your users will see your brand when they log in.


This guide walks you through the full setup.
Prerequisites
Before you begin, make sure you have:


  • A myCRMSIM account with white label access enabled
  • A domain you own (e.g., app.yourdomain.com)
  • Access to your DNS provider (GoDaddy, Cloudflare, Namecheap, Route53, etc.)
  • Your brand logo (PNG, JPG, SVG, or WebP — max 2MB)
  • Your brand favicon/icon (same formats — max 2MB)
  • (Optional) GHL OAuth credentials if you use GoHighLevel integration


    Step 1: Enable White Label Branding
    1. Log into the myCRMSIM dashboard 
    2. Click the "Setting" tab at the bottom of the left-hand sidebar.
    3. Click the "Branding" tab from the top navigation menu.
    4. Switch the "Enable Branding" toggle to ON.

      Once enabled, all branding configuration fields will appear.

      Step 2: Set Up Brand Identity

      Fill in these required fields:

      Field
      What it does
      Example
      Brand Name
      Your company name shown across the platform
      Acme Messaging
      Page Title
      Text shown on the browser tab
      Acme Dashboard
      Logo
      Drag and drop or click to upload your brand logo
      PNG recommended, max 2MB
      Favicon
      Small icon shown on browser tabs
      32x32 or 64x64 PNG/ICO  recommended, max 2MB
      Step 3: Configure Theme Colors
      Setting
      What it controls
      Default
      Primary Color
      Buttons, links, active elements
      #1D4ED8
      Secondary Color
      Backgrounds, borders
      #E5E7EB
      Navbar Component
      Navigation bar style
      ClientANavbar

      Click the color swatch to open the color picker. Enter a hex code directly or use the picker.

      Step 4: Choose Feature Visibility

      (Enabled or Disabled from myCRMSIM)
      Toggle features on or off depending on what you want your users to see:

      Toggle
      What it controls
      Support Chat
      Tawk.to live chat widget
      Signup Page
      Public registration page
      Help Link
      "Need Help? Book Onboarding" button in header
      Support Link
      Support link in navigation
      Tip: If you're white-labeling, you can enable Support Chat, Signup Page, and Help Link only if needed. These options are disabled by default for Sub-Account Admin and Sub-Account Users and will only be available if manually turned on.
       
      Step 5: Connect Your Custom Domain
      This is the most important step. It connects your domain (e.g., app.yourdomain.com) to the myCRMSIM platform.
      5a. Enter Your Domain
      1. In the Integration Settings section, find the Domain / Hostname field.
      2. Enter your domain without https:// or trailing slashes.
          3. Click Save Branding Settings first to register your domain.
       
      5b. Get Your DNS Records
      After saving, click the Check button next to the domain field. The system will show you two DNS records you need to add:
      Record 1 — SSL Verification (Required)

      This proves you own the domain. AWS needs this to issue an SSL certificate.

      Setting
      Value
      Type
      CNAME
      Name
      Provided by the system (e.g., _abc123.yourdomain.com)
      Value
      Provided by the system (e.g., _xyz789.acm-validations.aws.)

      Use the copy button to copy the exact values.

      Record 2 — Domain Routing (Required)

      This points your domain to the myCRMSIM servers via CloudFront.

      Setting
      Value
      Type
      CNAME
      Name
      Your domain (e.g., app.yourdomain.com)
      Value
      CloudFront domain (shown on screen, e.g., d123456.cloudfront.net)
       
      5c. Add DNS Records at Your Provider

      Go to your DNS provider and add both CNAME records. Here are quick instructions for common providers:

      Cloudflare:
      1. Go to your domain → DNS → Records
      2. Click "Add Record"
      3. Type: CNAME, Name: (paste), Target: (paste)
      4. Important: Set the proxy to DNS only (grey cloud icon). Orange cloud (proxied) will block SSL validation.
      5. Repeat for both records
      GoDaddy:
      1. Go to My Products → DNS → Manage
      2. Click "Add" under Records
      3. Type: CNAME, Name: (paste), Value: (paste), TTL: 1 hour
      4. Repeat for both records
      Namecheap:
      1. Go to Domain List → Manage → Advanced DNS
      2. Click "Add New Record"
      3. Type: CNAME Record, Host: (paste), Value: (paste), TTL: Automatic
      4. Repeat for both records
      Route53:
      1. Go to Hosted Zones → Select your domain
      2. Click "Create Record"
      3. Record type: CNAME, Name: (paste), Value: (paste)
      4. For root domains (@), use ALIAS instead of CNAME pointing to the CloudFront distribution
      5. Repeat for both records
         
        5d. Wait for Verification
        After adding DNS records:
        1. Go back to your myCRMSIM Settings page.
        2. Click the Check button again.
        3. The system will start polling for verification.
         
        Status progression:
        Status
        Meaning
        Typical Wait Time
        PENDING_VALIDATION
        Waiting for DNS records to propagate
        1–30 minutes
        VALIDATED
        SSL certificate issued, CloudFront updating
        1–5 minutes
        CLOUDFRONT_UPDATING
        CloudFront deploying your domain
        5–15 minutes
        ACTIVE
        Done! Your domain is live

        Note: DNS propagation can take up to 24 hours in rare cases. If status stays at PENDING_VALIDATION for more than an hour, double-check your DNS records are correct and there are no typos.
         
        Step 6: Integration Settings (Optional)

        These fields are only needed if you use GoHighLevel (GHL) integration:

        Field
        What it is
        OpenAI API Key
        If you use AI features — click "Test" to verify before saving
        Security Note: OpenAI API Key are stored securely and never exposed in public API responses.
         

        Step 7: Login Page Preview

        Scroll down to the "Login Page Preview" section to see a real-time visualization of your custom login screen.
        Step 8: Save and Verify
        1. Click Save Branding Settings.
        2. Wait for the success confirmation.
        3. Open your custom domain in a new browser tab (e.g., https://app.yourdomain.com).

        Verify the following:

        Check
        What to look for
        ✅ Logo
        Your brand logo appears on the login page and sidebar
        ✅ Favicon
        Your icon appears on the browser tab
        ✅ Page Title
        Your custom title appears on the browser tab
        ✅ Colors
        Buttons, links, and UI elements use your brand colors
        ✅ Features
        Only the features you enabled are visible
        ✅ SSL
        The browser shows a secure padlock (https://)
         
        White Label Portal Access

        With our white-label portal, you can enable a client or end-user (Subaccount Admin) to access the portal, log in under your branding, and manage their own devices and messages via the sub-account area.

         

         Procedure

        1. Access Sub-account Admin Area
        • Log in to your myCRMSIM dashboard as the agency/master account
        • Navigate to the Sub-account Admin section and create a new user
         
        2. Create the User & Assign Workspace
        • Enter a name for the user/sub-account (e.g., [email protected])
        • Assign the workspace/sub-account that this user will manage
        • Ensure the workspace has already been connected and is visible
        • Set the user’s status to Active
         
        3. Assign Device Allowance
        Choose how many devices the user can have:
        • Option A: Set a device allowance (e.g., 1 device) → the user will be able to add up to that many devices themselves
        • Option B: Assign specific device(s) → select device(s) from your existing list and assign them to the user so they do not have to add them themselves
        Note: If no devices are assigned, the user must add devices via the portal by following the installation steps
         
        4. Provide Login Details
        • Once the sub-account user is created, the login details are automatically sent to the user’s registered email address
        • The email will include:
          • The login URL (white-labeled under your branding, e.g., your custom domain like https://smsapp.yourdomain.com)
          • The username (usually the user’s email)
          • The password (if included or set during creation)
        When the user logs in, they can only see the permitted menu items:
        Dashboard, Messages, Sub-account SIM(s), Devices, (Workspaces and Contacts if enabled)
         
        Troubleshooting
        Domain stuck on PENDING_VALIDATION
        • Verify DNS records are exactly as shown (no extra spaces or missing dots)
        • Cloudflare users: Make sure proxy is OFF (grey cloud) for the SSL validation record
        • Wait at least 30 minutes — DNS propagation takes time
        • Use DNS Checker to verify your CNAME records are visible globally
        Domain shows ACTIVE but page doesn't load
        • Make sure the routing CNAME (Record 2) is also added
        • Clear your browser cache or try incognito mode
        • Wait 15 minutes — CloudFront deployments take time to propagate globally
        Login page shows default myCRMSIM branding
        • Check that the domain in settings exactly matches what you're visiting
        • Make sure branding toggle is ON and settings are saved
        • Hard refresh the page (Ctrl+Shift+R / Cmd+Shift+R)
        Logo or favicon not showing
        • File must be PNG, JPG, SVG, WebP, or ICO
        • File must be under 2MB
        • Re-upload and save again
        "Invalid domain format" error
        • Remove https:// or http:// from the domain
        • Remove any trailing slashes (/)
        • Domain must contain at least one dot (e.g., app.yourdomain.com)
         
        Important Notes
        • DNS records must be configured correctly before domain verification can succeed
        • Never share your Client Secret or OpenAI API Key
        • Subdomains work best (e.g., app.yourdomain.com). Root domains require Route53 with ALIAS records
        • After any branding changes, users may need to hard-refresh their browser to see updates
        • The white label applies to all users who access the platform through your custom domain
         

        Was this article helpful?

        0 out of 0 liked this article

        Still need help? Message Us