> For the complete documentation index, see [llms.txt](https://docs.helpyousponsor.com/guides/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.helpyousponsor.com/guides/core-features/donor-management/add-household.md).

# Add Household

Use **Add Household** when donors should be grouped under one household record. Household records help your team review household-level information, keep related donors connected, and use household workflows such as household year-end statements.

Open **Donors**, select **Households**, then select **Add Household**.

<figure><img src="/files/Cqagn0nZuprkbXw9QNd5" alt=""><figcaption><p>The Add Household drawer starts with the required household name and primary contact.</p></figcaption></figure>

<figure><img src="/files/PomXqWyOuvrGY0vUR658" alt="Animated walkthrough of adding a household"><figcaption><p>Walkthrough: creating a household with a primary and an additional contact.</p></figcaption></figure>

## Create the Household

1. Enter the **Household name**.
2. Choose the **Primary Contact**.
3. Add any **Additional Contacts**.
4. Expand **Additional Fields** if you need to add custom household details or a mailing address.
5. Select **Submit**.

The household name and primary contact are required. **Discard** closes the drawer without saving unsaved edits.

## Choose Household Contacts

Use **Primary Contact** for the main donor connected to the household.

<figure><img src="/files/F0VjTWfYOO6KkOGngBLf" alt=""><figcaption><p>The Primary Contact selector uses existing donor records.</p></figcaption></figure>

Use **Additional Contacts** for other donors who should belong to the same household. When you submit the household, HelpYouSponsor links the selected donor records to the new household.

Choose contacts carefully. Adding a donor to a household changes which household that donor belongs to.

## Add Household Details and Address

Open **Additional Fields** when you need to store more household information.

<figure><img src="/files/sVKpJuKaXXRPRMbOFmrF" alt=""><figcaption><p>Additional Fields includes custom household profile fields and mailing address fields.</p></figcaption></figure>

This section can include:

* custom fields from the household profile form
* address line 1
* address line 2
* city
* state or region
* postal code or zip code
* country

Add or change custom household fields from the [household profile form](/guides/core-features/program-management/program-forms.md).

## After You Submit

After the household is created, the Households table refreshes and the new record is available for review and household workflows. If required fields are missing, HelpYouSponsor keeps the drawer open and highlights the fields that need attention.

## Permissions

**Add Household** appears only when your role allows household management. If you can open the Households tab but do not see the add action, ask an account admin to review your permissions.

## Related Guides

* [Household Table](/guides/core-features/donor-management/household-table.md)
* [Donors Table](/guides/core-features/donor-management/donors-table.md)
* [Add Donor](/guides/core-features/donor-management/add-donor.md)
* [Donor Profile Page](/guides/core-features/donor-management/donor-profile-page.md)
* [Program Forms](/guides/core-features/program-management/program-forms.md)