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

# Adhesion (Membership Applications)

> Require a formal application, an ID check, a signature and admin review before granting full membership

Adhesion is Orgo's membership application module. An applicant fills a form you define, optionally uploads an identity document and records a short video, signs the application in the browser, and sends it to your team. Staff then move it through a review chain and either approve or reject it.

**Built for:** organisations that vet people before admitting them, such as professional associations, political parties, trade unions and cooperatives, and anyone who needs a signed, auditable record of who was admitted and by whom.

**Replaces:** a PDF application form plus email review, plus a separate place to store the signed copy.

**When you do not need it:** if you only want a light approval gate, set new registrations to a pending [status](https://orgo.space/docs/platform/users/statuses.md) instead. Adhesion is heavier: it adds an ID check, a signature and a multi-step review.

***

## Turning it on

**Settings** → **Users & Profiles** → **Configuration** → **Adhesion & Membership**. Requires `ADMIN_TENANT`.

![Adhesion and Membership settings section with the Enable Adhesion Module, Mandatory Adhesion, Video recording, Review steps and Require identity verification switches](https://mintcdn.com/orgo-dc7abe63/o3AjqCN517NINQ7V/images/platform/users/adhesion-settings.png?fit=max\&auto=format\&n=o3AjqCN517NINQ7V\&q=85\&s=eac4d7f014733143246c4b5bf50359d5)

| Setting | What it does | Default |
| - | - | - |
| **Enable Adhesion Module** | Turns the module on. Until it is on, the Adhesions menu item and the member's own application page are hidden. | Off |
| **Mandatory Adhesion** | Every new account gets an application in Initiated status the moment it is created, and the member is redirected to it on every page until the application succeeds. | Off |
| **Video recording** | Adds a video step after sending, where the applicant answers questions on camera. | Off |
| **Review steps** | Runs applications through form validation, background check and interview before the decision. Turn it off to decide straight from a sent application. | On |
| **Require identity verification** | Requires an ID document upload, and blocks the "form validated" step until that document is validated. | On |
| **Default User Type After Approval** | The [user type](https://orgo.space/docs/platform/users/user-types.md) assigned when an application is approved. | None |
| **Admin Email Address** | Extra address notified when an applicant sends an application. The local HR team is always notified as well. | None |
| **Draft Change Reasons** | The pick list an admin chooses from when sending an application back. Entries are separated by a pipe character, not by commas. | None |

> [!WARNING]
>
> With **Mandatory Adhesion** on, members are redirected to their application on every route until it reaches Adhesion success. Members holding `ADMIN_LOCAL` or above, and members who already hold the configured success user type, are exempt. Keep your review turnaround short.

***

## Building the form

**Settings** → **Users & Profiles** → **Adhesion Form** (`ADMIN_TENANT`). Each row has two checkboxes, include the field and make it required. Email is always included, always required, and cannot be unchecked.

![Adhesion form builder listing built-in profile fields with an include checkbox and a required checkbox on each row](https://mintcdn.com/orgo-dc7abe63/o3AjqCN517NINQ7V/images/platform/users/adhesion-form-builder.png?fit=max\&auto=format\&n=o3AjqCN517NINQ7V\&q=85\&s=870736a750a3c68c056a6eb36a7c5952)

The selectable built-in fields are: first name, last name, date of birth, gender, address street, address details, town born, town current, location on members map, chapter, user types, profession headline, profession job, profession expertise, profession sector, profession industry, phone number, ID serial and number, Facebook, Twitter, LinkedIn, Instagram, Telegram and TikTok profiles, personal number, education status, certifications, experience history, and fee level. Every [custom field](https://orgo.space/docs/platform/users/custom-fields.md) you have defined is listed underneath and can be added the same way.

Personal number, ID serial and number, and date of birth are only shown to people allowed to see private data. **Fee level** lets the applicant choose which [membership fee price](https://orgo.space/docs/platform/fees/fees.md) applies to them; that choice is written to their profile and printed on the generated document.

The **Iframe URL** button copies an embeddable link to the application page for your tenant. The applicant still has to be signed in, so this is a convenience for your own site, not an anonymous public form.

***

## What the applicant does

The member opens **My Adhesion** from their profile menu (`/adhesion`), or lands on it automatically when adhesion is mandatory. Staff with `HR_LOCAL` over the member's chapter can fill it in on their behalf from the member's profile, which opens the same page for that member. `/adeziune` still resolves to it as well.

![Member adhesion page on a phone, headed with the organization name and the applicant's name, showing the first step Upload identity scan image with a Front document drop area accepting JPG or PNG up to 10 MB, a note that the document is stored securely for identity verification, and a Continue button](https://mintcdn.com/orgo-dc7abe63/o3AjqCN517NINQ7V/images/platform/users/adhesion-member-steps.png?fit=max\&auto=format\&n=o3AjqCN517NINQ7V\&q=85\&s=98cc44d9a231e45e859b2a1fab76c290)

**1. Start adherence**

Creates the application in **Initiated** status. Everything after this point is editable only while it stays in Initiated.

**2. Upload identity scan image**

Shown only when **Require identity verification** is on. The front of the document is required; a back side can be added with the "Document has information on the backside" switch. Orgo runs OCR on the upload to pre-fill identity fields; if OCR fails the upload still succeeds and the applicant types the details manually.

**3. Complete the adhesion profile form**

The fields you selected in the form builder. Required custom fields must all have a value before the next step unlocks.

**4. Adhesion signature**

The applicant can download the unsigned document first, then signs on a canvas. Signing generates the PDF from your template with the signature embedded and stores it as the application's signed document. Staff filling the form on someone else's behalf get no canvas: they upload the signed file instead, up to 5 files.

**5. Send adhesion**

Moves the application to **pending**. Blocked until a signed document exists and, when identity verification is on, until an ID document has been uploaded. When the member sends it themselves, Orgo emails the configured admin address plus every HR member of their chapter.

**6. Video recording**

Only when **Video recording** is on. The recorder walks the applicant through a set of questions with a 5 minute total limit, and can be re-recorded while the application is Initiated or pending.

***

## Reviewing applications

**Management** → **Adhesions** in the sidebar, or `/adhesions`. Requires `HR_LOCAL`.

![Adhesions queue with status filter chips and counts, and per-row signed document download, video, identity state and status controls](https://mintcdn.com/orgo-dc7abe63/o3AjqCN517NINQ7V/images/platform/users/adhesion-admin-list.png?fit=max\&auto=format\&n=o3AjqCN517NINQ7V\&q=85\&s=b579463ee7ba97c188d7ceaf4544600e)

Status chips with live counts sit above a table of the applicant, age, chapter, sent and updated dates, the signed document and video downloads, the identity state, and a status dropdown. Filter by name, by user ID, and, with `HR_PARENT_LOCAL` or above, by chapter. `HR_TENANT` sees the whole tenant; everyone else is restricted to chapters they hold `HR_LOCAL` on. Applications marked Duplicated, and applications belonging to deleted members, never appear.

| Status shown | Meaning |
| - | - |
| **Initiated** | Draft. The applicant can still edit everything. |
| **pending** | Sent for review. |
| **Adhesion form validated** | An admin checked the submitted form. |
| **Background checked** | Background check recorded. |
| **Interviewed** | Interview recorded. |
| **Adhesion success** | Approved. |
| **Adhesion rejected** | Refused. |
| **Adhesion canceled** | Withdrawn or dropped, with a reason. |
| **Duplicated** | Marked as a duplicate and removed from the queue. |

With **Review steps** on, the queue offers the full chain: pending, validated, background checked, interviewed, then the decision. With it off, the review statuses are hidden and an admin goes straight from a sent application to success, rejected or canceled.

Gates on each move:

* **Adhesion form validated** requires a validated identity document, unless identity verification is off for the tenant.
* **Adhesion success** and **Adhesion rejected** require both the Interview conclusion and the Background conclusion, whenever Review steps is on.
* **Adhesion canceled** requires a cancel reason.
* Moving back to **Initiated** opens the Draft Change Reasons picker, deletes the signed document so it has to be signed again, and emails the applicant with the reasons you selected.

Every status change asks for confirmation and is written to the application log.

Approving flags the member as a full member, assigns the **Default User Type After Approval** (creating the underlying role assignment if the member did not have it), and stamps the date they became a full member. If their user type actually changed as a result, they get the approval email.

> [!NOTE]
>
> Approval does not change the member's account status. A member whose account is Inactive or Unapproved stays that way after approval; change the [status](https://orgo.space/docs/platform/users/statuses.md) separately.

### Conclusions and the audit log

The **Conclusions** and **Log** buttons on each row open the same screen, also at `/adhesion/{id}/log` with `HR_LOCAL`.

**Conclusions** holds three free-text notes: Interview conclusion, Background conclusion, and Adhesion cancel reason. They can be saved while the application sits at validated, background checked, interviewed or canceled. They are read-only once it reaches Adhesion success or Adhesion rejected, and cannot be saved at all while it is still Initiated, pending, Duplicated or a decision has been made.

**Log** shows who sent, validated, interviewed, decided on and last updated the application, each with a timestamp and a link to the person, followed by the system log entries with the raw field-level changes.

***

## The generated document

**Settings** → **Users & Profiles** → **Adhesion Template** (`ADMIN_TENANT`). The editor is three raw HTML areas (Header, Main Template, Footer), not a rich text editor. Leave one empty and Orgo falls back to its built-in default for that part. **Preview** renders your markup in a modal.

![Adhesion template editor with Header, Main Template and Footer HTML code areas and a Preview button](https://mintcdn.com/orgo-dc7abe63/o3AjqCN517NINQ7V/images/platform/users/adhesion-template.png?fit=max\&auto=format\&n=o3AjqCN517NINQ7V\&q=85\&s=514dc5b1ad3f6257f9561caedafe684b)

These placeholders are replaced when the PDF is generated:

| Group | Placeholders |
| - | - |
| Identity | `{{firstName}}`, `{{lastName}}`, `{{personalNumber}}`, `{{dateBirth}}`, `{{gender}}`, `{{idSerialNumber}}`, `{{address}}`, `{{idTown}}`, `{{idCounty}}`, `{{country}}` |
| Contact | `{{email}}`, `{{phoneNumber}}`, `{{facebook}}`, `{{linkedin}}`, `{{instagram}}`, `{{tiktok}}` |
| Organisation | `{{localCenterName}}`, `{{localCenterAddress}}`, `{{feePrice}}` |
| Professional | `{{professionIndustry}}`, `{{professionJob}}`, `{{professionExpertise}}`, `{{professionSector}}`, `{{hasExperienceHistory}}`, `{{experiences}}` |
| Education | `{{educationStatus}}`, `{{educationDegree}}`, `{{certifications}}` |
| Signature block | `{{signature}}`, `{{dateSignature}}` |

For a custom field, use `{custom_field_<id>}` with the field's numeric id (single braces). File-type custom fields render as a download link; yes/no fields render the labels you configured. `{{educationDegree}}`, `{{certifications}}` and `{{experiences}}` expand to HTML tables, so put them on their own line rather than inside a sentence.

***

## Emails

Five emails belong to this flow. They are listed under **Adhesion** at **Settings** → **Emails & Notifications** → **Emails**, each with its own switch and **Turn all off** for the five together, and each can be reworded with **Edit text** (see [Email templates](https://orgo.space/docs/platform/emails/email-templates.md)). Your wording reaches every applicant as written, whatever language they read the platform in.

| Email | Sent to | Trigger |
| - | - | - |
| `adhesion_pending_admin` | Admin Email Address plus the chapter's HR team | Applicant sends their application |
| `adhesion_draft` | Applicant | Application sent back to Initiated, with the selected reasons |
| `adhesion_validated_member` | Applicant | Application moved to Adhesion form validated |
| `adhesion_rejected` | Applicant | Application rejected |
| `adhesion_success` | Applicant | Application approved and their user type changed |

***

## Troubleshooting

> [accordion] The applicant cannot press Send
>
> Sending needs a signed document and, when identity verification is on, an uploaded ID. If the form was filled by staff, the signed file has to be uploaded manually.

> [accordion] I cannot move an application to Adhesion form validated
>
> The identity document has to be validated first, with the **Validate** button in the Identity column of the queue. If you do not run identity checks, turn **Require identity verification** off and both the precondition and the upload step disappear.

> [accordion] The queue refuses my decision and asks for conclusions
>
> With **Review steps** on, open **Conclusions** on that row, save both the Interview and Background conclusions, then set the status.

> [accordion] The applicant says they never got the approval email
>
> It only goes out when approval actually changes their user type, so nothing is sent if they already held the type set in **Default User Type After Approval**. Also check that the email is switched on under **Adhesion** on the **Emails** page.

> [accordion] An application needs to be redone from scratch
>
> Set its status back to **Initiated**: this deletes the signed document and reopens every step. Applications that were rejected or marked Duplicated also show a **Reopen** button on the applicant's own page for staff with `HR_LOCAL`.

> [accordion] A member resigned but still shows an application
>
> Approving a [resignation](https://orgo.space/docs/platform/users/resignation.md) detaches the application from the member when a guest user type is configured, so their profile no longer points at it. The application row itself is kept as a record.

***

## Related

* [Identity Validation](https://orgo.space/docs/platform/identity-validation.md) - the ID document check the validation step depends on
* [User Types](https://orgo.space/docs/platform/users/user-types.md) - what gets assigned on approval
* [Custom Fields](https://orgo.space/docs/platform/users/custom-fields.md) - adding your own questions to the form
* [Registration Form](https://orgo.space/docs/platform/users/registration-form.md) - what people fill in before the application
* [User Statuses](https://orgo.space/docs/platform/users/statuses.md) - the account status, which approval does not change


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.