> For the complete documentation index, see [llms.txt](https://help.tahua.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.tahua.io/product-news/2026/june/grant-applicant-role-creates-registration-entity-via-modal.md).

# Grant Applicant Role creates a RegistrationEntity via modal

## Problem

When an admin used "Grant Applicant Role" on an assessor's profile page, the action only assigned the Registered Provider role to that user — it did not create a `RegistrationEntity` for them. Without an entity, the assessor would not appear in the Applicants list, could not be selected as an "existing applicant" when setting up Private Funding Rounds, and may have encountered issues during the application process.

The workaround was to use the "Invite New Applicants" flow on a Private Funding Round using the assessor's exact email address — confusing and unintuitive for admins.

## How It Works

Clicking "Grant Applicant Role" on an assessor's detail page now opens a modal with two options:

**Option 1 — Add to an existing entity:**

* A searchable dropdown lets the admin find and select any existing applicant entity in the system.
* On confirmation, the assessor is added as a member of that entity and the applicant role is granted.

**Option 2 — Create a new entity:**

* The admin clicks "Create a new entity instead" to switch sections within the modal.
* If the organisation has multiple registration types (e.g. Individual and Organisation), the admin selects the appropriate type via radio buttons.
* For organisation types, the admin enters an entity name. For individual types, the entity name is automatically set to the assessor's full name.
* On confirmation, a new `RegistrationEntity` (and its linked registration entry) is created, the assessor is set as the account owner, and the applicant role is granted.

## UI Changes

* The "Grant Applicant Role" button on the assessor detail page now opens a modal rather than triggering a direct action.
* The modal follows the same two-section toggle pattern used in the Contracts Wizard (search existing / create new).
