> ## Documentation Index
> Fetch the complete documentation index at: https://developers.entri.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Entri Unify Overview

> A single SDK call that lets users buy a new domain or connect one they already own.

## Overview

Most SaaS products depend on a working custom domain to deliver their core value, whether that's a website, an email address, or a branded storefront. Getting there means the user either buys a domain or configures one they already own, and until that domain is live the user is blocked. They can't send email from their brand, serve their site, or use whatever your platform sold them.

**Entri Unify** is the call that closes that loop. `entri.showUnify(config)` presents a centralized modal where the user chooses to buy a new domain or connect an existing one, then routes them through the right Entri flow automatically. When that flow completes, the domain goes from purchased or owned to fully functional inside your platform.

Before Unify, offering both paths meant building your own selection UI, writing conditional logic to invoke the right flow, and managing two separate integrations. Unify removes that complexity. You make one call and Entri handles the path selection and the routing.

## How it works

1. You call `entri.showUnify(config)` and Entri opens a centralized modal.
2. The user chooses between "Buy a new domain" and "Connect a domain."
3. Based on that choice, Entri internally routes to the matching flow:
   * **Buy a new domain** runs the Entri Sell flow (`purchaseDomain()`), which handles the purchase and auto-configures DNS.
   * **Connect a domain** runs the Entri Connect flow (`connectDomain()`), which guides the user through DNS setup for the domain they already own.
4. Entri applies the records you defined and monitors propagation, just as it does for the underlying flows.
5. Entri automatically adds the domain to [Entri Monitor](/monitor/overview), which watches its DNS records for later changes.

## When to use Entri Unify

Use Unify when you want to offer both the purchase and connect paths through a single unified entry point, or when you want Entri to handle the path-selection experience on your behalf. If you only ever need one path, you can continue to call `connectDomain()` or `purchaseDomain()` directly. Unify does not replace Connect or Sell as standalone products. It sits in front of them as a single front door for partners who need both.

## Key features

**Single integration** replaces the selection UI and branching logic you would otherwise build yourself. One call to `showUnify()` covers both the purchase and connect paths.

**Centralized path selection** presents the "buy" and "connect" choice in an Entri-managed modal, so you never build or maintain that screen. The modal is built on Entri's [new UI](/connect/new-ui) and is themed with the same `whiteLabel` object as the rest of the flow. **Automatic routing** sends the user into the Entri Sell or Entri Connect flow based on what they pick, with no state to manage across the two.

**Consistent configuration** lets you define your DNS records once and have them applied no matter which path the user takes, and **propagation monitoring** carries through from the underlying flow so you're notified when the domain goes live.

**Built-in DNS monitoring** enrolls every domain in [Entri Monitor](/monitor/overview) automatically, so you're alerted if the records change or break after setup. This is included only with `showUnify()`. The standalone `connectDomain()` and `purchaseDomain()` calls enroll domains in Monitor when you pass `monitor: true` in the config.

## Quick links

<CardGroup cols={2}>
  <Card title="Configuration" icon="gear" href="/unify/configuration">
    Full showUnify() config key reference
  </Card>

  <Card title="Events" icon="bell" href="/unify/events">
    Browser events and webhook notifications
  </Card>

  <Card title="Migration" icon="arrows-rotate" href="/unify/migration">
    Upgrade an existing Connect or Sell integration
  </Card>

  <Card title="Connect & Sell" icon="code" href="/connect/overview">
    The flows Unify routes into
  </Card>
</CardGroup>
