This guide covers how to build a branded Retool portal for customers, vendors, partners, or even internal users.
To get started building a Retool Portal, you must be on the Business plan or above. You also need to be logged in as an Admin user so you can create permission groups, add custom domains, and manage branding settings.
1. Set up your organization
With Retool Portals, you have additional options for branding and customization. This includes customizing the:
- Organization name
- Domain name
- Accent and header colors
These options allow you to customize the portal experience so it matches either your brand, or your users' brand.
Add your organization name
When you set your organization name and enable Remove extra references to Retool, all page titles and mentions of Retool are replaced with your organization name throughout the product experience.
Add a custom domain
If Retool hosts your instance, follow the Configure a custom domain for your Cloud organization guide to add a custom domain to your cloud organization. If you are running self-hosted Retool, configure your custom domain in your cloud provider's settings.
After your domain is verified, you can log into your organization at
<yourdomain>/auth/login. Log out and back in using your custom domain, and continue.
You can customize login and password reset pages, as well as emails for inviting a user and resetting a password. Customization includes the logo, a favicon, accent colors, and more.
When customizing emails, to remove all references to Retool, you must enter a From name and a Reply-to address.
Emails are sent from
email.retool.com by default, but you can reach out to try a new feature that allows you to use your own email provider.
2. Build your home page
To improve the onboarding experience into your portal, Retool recommends building a Retool app that serves as your home page. An example app might look like this.
Pharmacist Manager permission group:
3. Configure permissions
Create and configure a permission group for your end users.
Within this permission group, make sure:
- The group only allows Use access to the relevant applications.
- Users have No access to the Query Library or other pages in Retool. Go to the permission group's Additional tab to set this.
The All users permission group must also have default permissions set to Define specific access. This ensures that new users only inherit the permissions based on the groups they belong to.
Set a workspace
To route users to this home page based on their permission groups after they log into Retool, create a workspace in your permission group settings. Users should not belong to any other permission groups with workspaces set. If users belong to multiple permission groups with workspaces set, they won't be routed to the appropriate Retool app.
4. Build your Retool app
Now that you've configured your organization, set permissions, and configured a workspace for your end users, it's time to build your main Retool apps. Follow our quickstart guide to get started.