License Management

License & Permission Management

To ensure users can view and interact with Avonni Components, specifically on Experience Cloud sites, you must complete a two-step configuration process.

⚠️ Configuration Requirement: For a user to successfully access Avonni Components, you must assign BOTH:

1. A Package License (Allocates a seat to the user).

2. A Permission Set (Grants technical access to the components).

Important

If a user has a License but no Permission Set (or vice versa), the components will not load, and the user will see an error message.

---

Step 1: Assign Package Licenses

The package license grants the user the fundamental right to use the software within Salesforce.

License Availability:

• Production: Includes 10 Freemium licenses.

• Sandbox: Includes a Site License (Unlimited users/No expiration).

How to Assign:

1. Navigate to Setup.

2. Search for and select Installed Packages.

3. Locate Avonni Experience Components and click Manage Licenses.

4. Click Add Users.

5. Select all users who require access and click Save.

---

Step 2: Assign Permission Sets

Once the license is assigned, you must assign the correct Permission Set based on the user's role. The Avonni package includes three distinct permission sets.

Choose the correct permission set for your user:

Role	Permission Set Name	Function
End Users (Experience Cloud & App Builder)	Avonni Experience Cloud Components User	Required for users viewing components on Experience Sites or standard Lightning App Builder pages.
End Users (Dynamic Components)	Avonni Dynamic Components User	Required for users interacting with Dynamic Components (e.g., custom Data Tables, action buttons) inside Salesforce.
Admins & Builders	Avonni Experiences Admin	Required for users who need to create, edit, or build layouts using the Avonni Component Builder.

How to Assign:

1. Navigate to Setup > Permission Sets.

2. Select the appropriate Permission Set from the table above.

3. Click Manage Assignments > Add Assignment.

4. Select the users to whom you assigned licenses in Step 1.

5. Click Assign.

---

Configuration for Guest Users

Guest users (unauthenticated visitors on public sites) do not require a standard Package License, but they do require permissions.

Note

Guest User access for Production environments is an add-on feature. Please get in touch with support for details.

To enable Guest Access:

1. Open your Experience Cloud site in Builder.

2. Go to Settings > General and click the link to the Guest User Profile.

3. In the Profile settings, scroll to Permission Set Assignments.

4. Add the Avonni Experience Cloud Components permission set to the profile.

Troubleshooting Access Issues

If a user reports the error "You don't have access to this Avonni Component," check the following:

Issue	Solution
Missing License	Ensure the user is listed in Installed Packages > Manage Licenses.
Missing Permission	Ensure the user has the Avonni Experience Cloud Components permission set assigned.
LWS Disabled	Ensure Lightning Web Security is enabled in Setup.