Configure a branded customer portal URL
Updated
Who can do this: Anyone on your team who can change your domain's DNS settings
Your customer portal URL defaults to companyname.portal.onramp.us. You can use your own subdomain instead, such as onboard.yourcompany.com, so customers see your brand in the address bar.
Before you begin
You need access to the DNS settings for your domain, usually at your domain registrar or DNS provider.
Choose the subdomain you want to use. Short, clear names work well, such as
go.yourcompany.com,onboard.yourcompany.comorwelcome.yourcompany.com.Find out your organization's hosting region. It decides where your CNAME record points. If you're not sure, ask your OnRamp team.
Add a CNAME record
Sign in to your domain registrar or DNS provider.
Add a new DNS record of type CNAME.
Set the host to the subdomain you chose.
Point the record to OnRamp's portal address for your region:
custom.onramp.usfor the standard regioncustom-gdpr.onramp.usfor organizations hosted in the GDPR (EU) region
Save the record.
If you use Cloudflare or a similar service, set the record to DNS only, not proxied. OnRamp can't start your SSL certificate until it finds a CNAME in your subdomain's DNS that names its portal address. A proxied record can hide that CNAME, so the certificate never gets requested.
Ask OnRamp to finish setup
Contact OnRamp support with the subdomain you configured.
Our team finalizes the setup and turns on SSL for your branded portal. The certificate is only issued after your CNAME resolves to OnRamp. Once it's issued, it's attached to your portal a short time later.
Check your setup
Test your DNS: Run a CNAME lookup for your subdomain. It should resolve to
custom.onramp.us, orcustom-gdpr.onramp.usif your organization is in the GDPR region.Allow time for DNS: Your DNS provider controls how fast changes spread. It often takes a few hours and can take up to 24 hours.
Certificate errors: A certificate error usually means SSL is still being set up. If the error lasts more than a few hours, contact your OnRamp team.
A certificate that failed: If a certificate fails, for example because validation timed out, OnRamp requests a new one for the same subdomain about once a day. This only works while your CNAME still points to OnRamp, so keep the record in place.