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

# Merging households

> Combine two households into one, transferring all data to the target household.

Merging combines two households into one. All notes, tasks, meetings, emails, activity history, and financial accounts transfer to the target household. The source household is removed after the merge.

You can merge any combination of household types — clients, prospects, and past clients.

## Merge from a single household

<Steps>
  <Step title="Open the more menu">
    From either household, click the **...** menu and select **Merge with household**.
  </Step>

  <Step title="Select the other household">
    Search for and select the household you want to merge with. Click **Next**.
  </Step>

  <Step title="Assign member roles">
    You'll see all people from both households. For each person, choose a role — such as **Head of household**, **Spouse**, **Partner**, **Other adult**, or **Dependent child** — or select **Delete** to remove them.

    Every household must have exactly one head of household and at least one person remaining.
  </Step>

  <Step title="Click Merge households">
    The merge runs and you're redirected to the surviving household.
  </Step>
</Steps>

## Merge from the list

You can also kick off a merge by selecting exactly two households in the **Clients** or **Prospects** list.

<Steps>
  <Step title="Select two households">
    Check the boxes next to the two households you want to merge. The selection bar appears at the bottom.
  </Step>

  <Step title="Click Merge">
    The merge dialog opens in pair mode and asks which household should remain.
  </Step>

  <Step title="Choose which household will remain">
    Pick the household to keep — the other one's data merges into it. The picked household is marked **will remain**. Click **Next**.
  </Step>

  <Step title="Assign member roles">
    Assign roles for everyone in the combined household, then click **Merge households**.
  </Step>
</Steps>

<Warning>
  When you start from a single household, the household you **select** in the **Select the other household** step is the one that remains — the household you started from is merged into it and then removed. When you start from the list with two selected, you choose which household remains in the first step. Either way, the confirmation screen spells out which household will remain and which will be deleted before you finish.
</Warning>

## What transfers during a merge

Everything associated with the source household moves to the target:

* **Notes** — All notes, including notes linked to people in the household
* **Tasks** — All tasks and task recurrences
* **Meetings** — Meeting associations are combined. If both households attended the same meeting, the duplicate is removed automatically.
* **Emails** — Full email history
* **Activity history** — All activity records. Duplicate activities (same action on the same record) are deduplicated automatically.
* **Financial accounts** — Custodian accounts and portfolios are consolidated. If both households have a portfolio, the source's accounts move into the target's portfolio.
* **Custom fields, vault files, and other records** — All remaining household-scoped data transfers to the target.

## Duplicate person detection

When assigning roles, Slant automatically detects potential duplicates between the two households by matching on email address or full name. Duplicates are flagged with a badge so you can choose to delete one of them.

<Tip>
  Review flagged duplicates carefully before merging. Deleting a person removes their contact details, but notes, tasks, and meetings linked to them are preserved on the target household.
</Tip>

## FAQ

<AccordionGroup>
  <Accordion title="Can I undo a merge?">
    No. Merging is permanent. The source household is deleted after its data transfers to the target. Make sure you've selected the correct target before confirming.
  </Accordion>

  <Accordion title="What happens to the source household after merging?">
    The source household is automatically deleted once all its data has been transferred and no associated records remain.
  </Accordion>

  <Accordion title="Does the household type change after a merge?">
    No. The target household keeps its current type (client, prospect, or past client). If you need to change the type, [convert between types](/records/households/overview#converting-between-types) after the merge.
  </Accordion>

  <Accordion title="Who can merge households?">
    Any user with edit access to both households in the same book can perform a merge.
  </Accordion>
</AccordionGroup>

## Next steps

<CardGroup cols={2}>
  <Card title="Households overview" icon="house" href="/records/households/overview">
    Detail page layout, tags, tiers, and shared features
  </Card>

  <Card title="People" icon="user" href="/records/people">
    Manage the individuals within your households
  </Card>
</CardGroup>