How to Assign a Permission Package to Users

Once a Package has at least one active permission, you can assign it to one or more users at once using the four-step wizard.

The assignment wizard

Step 1 — Package confirmation

The first card confirms which package you are assigning. It shows the package name and description. This step is informational — no input is needed.

Step 2 — Select users

1. Click Search user to open the user picker modal. Search by last name or personal code and click a result to select them.
2. After selecting a user, their personal code and name appear in the input fields. Click Add to add them to the list.
3. Repeat to add multiple users. Each user added triggers an automatic conflict check — if the user already holds any of the package permissions from another source, a warning row appears with two options:
   • Keep Package — the existing authorization is disabled and replaced by the package grant.
   • Keep Original — the existing authorization is preserved and the package grant is skipped for that permission.
4. To remove a user from the list before confirming, click Remove on their row.

Step 3 — Permissions preview

A read-only table lists every permission that will be granted: application, permission slug, value, and parameter. Review this carefully before confirming — the grants take effect immediately.

Step 4 — Confirm

Click Confirm to execute the assignment. The system will:

1. Grant each permission to each user via app_auth, using source = package:N.
2. Record the assignment in packages_users.
3. Generate a PDF assignment report and save it to the file manager. A download link appears in the success message.

User already assigned to this Package

If a user is already an active member of the Package (i.e. they appear in the Active section of the Users column), they cannot be added again via the wizard — the system skips them and shows a warning. To update their permissions, use the Sync action instead.