# Design distributor onboarding for Emerging Household Energy

> A checklist for onboarding a distributor to Emerging Household Energy: register its identity, set permissions, link it to a project and test the result.

This page is about **Emerging Household Energy**: bringing a distributor into a household energy
programme. When you finish, the distributor is registered as an authorised participant, has
submitted its onboarding evidence, and can take part in distribution and reporting. It is a public
checklist for implementation teams, not a description of internal test runners.

<Info>
  This is a design guide. It lists what onboarding must achieve and in what order, and gives nothing
  to run. The registration and credential steps it relies on are in
  [Emerging Platform domain registration](/platforms/Emerging/domain-registration) and
  [Emerging Platform credential issuance](/platforms/Emerging/credential-issuance).
</Info>

## Before you start

- You have access to the solution operator's workflow, the integration environments and the
  permissions you need.
- The project, organisation and agent identities are ready.
- Registry and credential issuance flows are available.
- The distributor's supporting documentation is available.

## Steps

1. Register the distributor's organisation as a domain, with its identity and controller details.
   See [Domain registration](/platforms/Emerging/domain-registration) and
   [Digital identifiers](/platforms/Emerging/digital-identifiers).
2. Submit the onboarding profile and the documentation it requires.
3. Complete the verification checks and the approval workflow.
4. Configure the distributor's permissions and operational roles.
5. Link the distributor to the relevant project, delivery scope and reporting workflows.
6. Confirm that claim submission and credential verification work for the distributor. See
   [Credential issuance](/platforms/Emerging/credential-issuance).
7. Run a dry-run onboarding and check the outputs.

## Check the result

Onboarding is complete when:

- the distributor can submit the records it is allowed to
- the distributor's records resolve to the expected project scope
- downstream reporting includes events linked to the distributor

## Next steps

- [Emerging Household Energy dMRV](/platforms/Emerging/emerging-dmrv): the workflow the distributor
  takes part in.
- [Household monitoring](/platforms/Emerging/household-monitoring): household monitoring and
  operations.
- [Digital vouchers](/platforms/Emerging/digital-vouchers): how suppliers redeem household
  vouchers and claim for delivery.