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.
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:
| Type | Name | Value | What it's for |
|---|---|---|---|
| CNAME | pim.yourcompany.com | clientes.bruxel.ai | Takes your subdomain to Bruxel |
| TXT | _bruxel-verify.pim.yourcompany.com | The 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.
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.
| Status | What it means |
|---|---|
| Pending | The records are missing or haven't been verified yet. |
| Active | Your domain is working. |
| Having problems | We 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”. |
| Suspended | There 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 see | What it usually is | What to do |
|---|---|---|
| It doesn't find the CNAME | The change isn't visible on the internet yet, the name got duplicated (pim.yourcompany.com.yourcompany.com) or the Cloudflare proxy is on | Wait a few minutes, check the name and leave the record as “DNS only” |
| The CNAME points somewhere else | There's another record on that name, or the value isn't the one on the screen | Keep only the CNAME, with the value from the screen |
| It doesn't find the TXT | The name got duplicated, or the value has extra spaces or quotes | Copy the name and the value from the screen again |
| The DNS didn't answer | Your domain's DNS server didn't respond in time | Verify again in a few minutes; nothing changes in the meantime |
| The browser can't open a secure connection | Your domain isn't active yet | Verify 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 TXT | Create them again and press “Verify now” |