All courses

Bruxel on your own domain

Your team and your suppliers can sign in to Bruxel from an address of your company, like pim.yourcompany.com, with your logo on the sign-in page and the links in emails pointing there.

What changes and what doesn't

Your domain is another door into the same organization. It changes the address people use to get in, not who gets in: that is still decided by your organization's invitations, just like on bruxel.ai.

  • It works with a subdomain, like pim.yourcompany.com. A root domain, like yourcompany.com on its own, can't be used.
  • When you sign in through your domain you land straight in your organization, without having to pick it.
  • Your team and your suppliers sign in there, and the invitations and notifications that open the app carry your domain.
  • bruxel.ai keeps working the same for your organization.
On your domain you sign in with email and password; two-step verification and password recovery work the same. There's no open sign-up: only people invited by your organization get in.

What stays on bruxel.ai

Some things don't depend on your domain, on purpose:

  • Bruxel's public pages (pricing, Academy, blog). If someone opens them on your domain, we take them to bruxel.ai.
  • The public API and the developer portal.
  • Receipts, the link to stop receiving emails and the legal documents, so they never depend on your company's DNS.

What it costs

100 credits a month per domain, from your balance. The first month is charged on the day your domain is activated, and then every month on the same date.

If one month your balance doesn't cover it, your domain keeps working for 15 days and we let you know in the bell. If the 15 days go by without balance, it's suspended: whoever opens it lands on bruxel.ai and signs in as always, without losing anything. When you top up, your domain comes back on its own, by the next day at the latest.

How to request it

For now, the Bruxel team sets up the domain. Write to us from the help center with the subdomain you want to use, for example pim.yourcompany.com.

As soon as we set it up, in Channels → Custom domain you'll see your domain's status and the two records to create. That screen is visible to your organization's admins and owner.

The two DNS records

They're created in the panel of whoever manages your company's DNS: your domain provider, your hosting or your IT team. Copy the name and the value exactly as they appear on the screen:

TypeNameValueWhat it's for
CNAMEpim.yourcompany.comclientes.bruxel.aiTakes your subdomain to Bruxel
TXT_bruxel-verify.pim.yourcompany.comThe code that starts with bxv-Proves the domain is yours
  • If your panel already adds your domain at the end of the name, type only the part before it: pim for the CNAME and _bruxel-verify.pim for the TXT.
  • There can't be another record on that name: if pim.yourcompany.com already has one (for example, an A record), remove it before creating the CNAME.
  • If your DNS is on Cloudflare, leave the CNAME as “DNS only”, with the grey cloud. With the proxy on, Bruxel can't see the record and your domain can't be activated.
  • You don't need to touch your domain's CAA record, even if it only authorizes another company to issue certificates: we add that authorization ourselves.
DNS changes take anywhere from a few minutes to a few hours to show up on the internet.

Verify and activate

With both records created, press “Verify now” in Channels → Custom domain. If everything checks out, your domain is activated and the first month is charged. If your balance doesn't cover it, it stays pending until you top up.

If something is missing, the screen tells you which record it didn't find or which value it found instead.

StatusWhat it means
PendingThe records are missing or haven't been verified yet.
ActiveYour domain is working.
Having problemsWe check your domain every day and we no longer find the CNAME or the TXT. Meanwhile, your team signs in through bruxel.ai. Once you create them again, it reactivates on its own at the next check, or when you press “Verify now”.
SuspendedThere was no balance for the month and the 15 days went by. Once you top up it comes back on its own, by the next day at the latest.

The first time you open it

The first visit takes a few extra seconds: that's when your domain's security certificate is issued. After that it loads as usual.

The sign-in page shows your logo and your organization's name. If you don't have a logo yet, upload it in Account → General, under “Organization logo”.

Sessions are per address: even if you're already signed in on bruxel.ai, you sign in once on your domain. If someone who isn't part of your organization gets in, they see a notice with a link to bruxel.ai.

When something doesn't add up

What you seeWhat it usually isWhat to do
It doesn't find the CNAMEThe change isn't visible on the internet yet, the name got duplicated (pim.yourcompany.com.yourcompany.com) or the Cloudflare proxy is onWait a few minutes, check the name and leave the record as “DNS only”
The CNAME points somewhere elseThere's another record on that name, or the value isn't the one on the screenKeep only the CNAME, with the value from the screen
It doesn't find the TXTThe name got duplicated, or the value has extra spaces or quotesCopy the name and the value from the screen again
The DNS didn't answerYour domain's DNS server didn't respond in timeVerify again in a few minutes; nothing changes in the meantime
The browser can't open a secure connectionYour domain isn't active yetVerify it first; the first visit after activating it issues the certificate
Your domain moved to “Having problems”Someone deleted or changed the CNAME or the TXTCreate them again and press “Verify now”
If the screen says an authorization is missing on our side, you don't need to change anything in your DNS: write to us from the help center and we'll fix it.