The Custom User Portal is a white-label solution that lets agencies offer a branded admin interface to their clients. Instead of seeing ChatLab branding, your clients log in to a portal under your domain with your logos and company name.
What clients can do in the portal
Agencies share prepared chatbots with their clients through the portal. Clients cannot create their own chatbots, but they can manage the bots shared with them:
- Train the chatbot with new content
- Manage selected bot settings
- Add corrections to improve responses
- View chatlogs and analytics
This gives your clients hands-on control while you maintain ownership of the chatbot configuration.
Where to find Custom User Portal settings
Go to Account Settings in the main navigation menu, then select Custom User Portal in the left sidebar.
Prerequisites
You must have a custom domain configured before enabling the Custom User Portal. The Admin App Subdomain you set during custom domain setup becomes the address for your portal. For example, if your domain is brightwave.com and you entered admin as the Admin App Subdomain, your portal will be available at admin.brightwave.com.
If no custom domain is configured, the page displays a message asking you to set one up first.
Enable the portal
Once your custom domain is active, click Enable Custom User Portal to reveal the configuration form.
Configure portal settings
After enabling, the full settings form appears.
Branding
-
Brand Name -- your agency name, displayed throughout the portal in place of "ChatLab"
-
Website URL -- your agency's website, shown in the portal footer as a branded link
-
Privacy Policy URL -- link to your privacy policy, required during client registration
-
Terms of Service URL -- link to your terms of service, also required during registration
Logos
Upload three logo variations used across the portal:
- Brand Icon (min 200x200px) -- used in dialogs and confirmations
- Logo for dark background (min 400x160px) -- transparent background, for display on dark surfaces such as the sidebar
- Logo for light background (min 400x160px) -- transparent background, for display on light surfaces
Custom SMTP
Toggle Enable custom SMTP settings to send all portal emails from your own mail server. When enabled, provide:
- SMTP Host -- your mail server address (e.g.
smtp.brightwave.com) - SMTP Port -- the server port (e.g.
587) - SMTP Username and SMTP Password -- credentials for authentication
- From Name -- the sender name shown in emails (e.g.
BrightWave Support) - From Email -- the sender address (e.g.
no-reply@brightwave.com)
After saving, a Send Test Email button appears so you can verify your SMTP configuration works correctly.
Custom CSS
Optionally add up to 5,000 characters of custom CSS to further style the portal's appearance beyond the logo and brand name changes.
User Portal Chatbot ID
Optionally embed a helper chatbot inside the portal to assist your clients. Train one of your chatbots with information about how to use the portal, then paste its Chatbot ID here. The Chatbot ID is visible on the bot's Overview tab, below the bot name.
Save and domain verification
Click Save Settings to submit your configuration. If this is your first time enabling the portal, the system initiates a domain verification process for your Admin App Subdomain:
- You receive an email with CNAME records to add to your DNS
- After DNS verification, the portal infrastructure is provisioned automatically
- You receive a confirmation email once the portal is live
A pending status message appears on the settings page while the subdomain is being verified. You can cancel the request at any time.
Removing the portal
Click Remove Custom User Portal at the bottom of the settings form to disable the portal. A confirmation dialog appears before any changes are made.
Related articles
- Custom Domains -- prerequisite for the user portal
- How does the agency program work? -- overview of agency partnership options