What is a Custom Auth Domain, and how do I set it up?

When visitors use 1-click social connections (like Google or Microsoft), the identity provider displays a "callback URL" on their consent screen. By default, this URL displays as breadbutter.io.

Setting up a Custom Auth Domain acts as a white-label proxy, replacing our branding with your own to maximize user trust and prevent conversion drop-off at the critical moment of sign-up.

Here is what you need to do to get it configured:

• Choose a Subdomain: Pick a standard, secure naming convention like auth.yourwebsite.com .

⚠️ Important: Because you will be creating a dedicated CNAME record for this, you must ensure the subdomain you choose is not already being used for something else.

• Configure Your DNS: After submitting your requested subdomain in your Bread & Butter dashboard, our system will generate a unique configuration for you. You will receive an email shortly containing specific CNAME records. Simply copy those records and add them to your domain hosting provider's DNS settings (such as GoDaddy, AWS, Azure, etc.).
• Update Your Identity Providers: This is a critical step! Once your Custom Auth Domain is active, you must log back into your developer accounts for every custom identity provider you have enabled (like Google or Microsoft). You must update their "Authorized Redirect URIs" (or Callback URLs) to match your new custom subdomain. If you skip this step, your social connections will fail to authenticate and will stop working entirely.
• Final Verification: Once you have updated your DNS and identity providers, click the "I've completed both steps" confirmation button in your Bread & Butter dashboard. Our team will verify your routing, and your fully white-labeled setup should be live within one (1) business day.