Installation & Licenses Management
This guide covers the essential steps to get Avonni Dynamic Components running in your Salesforce environment.
Overview
Before configuring users, it is important to understand that access to Avonni Components is controlled by a two-step security model. For a user to successfully view or interact with a component, they must have BOTH:
A Package License: This allocates a specific "seat" to the user (managed in Installed Packages).
A Permission Set: This grants the technical rights to load the component code (managed in Permission Sets).
Note: If a user has a License but no Permission Set (or vice versa), the components will not load, and they will encounter an error.
Environment & Limits
Sandbox Environments: Installation includes a Site License. You have unlimited users and no time limits for testing and development.
Production Environments: Installation includes a Freemium Plan with 10 Licenses. If you need to grant access to more than 10 users, you will need to purchase additional licenses
Installation
Critical Prerequisite: Lightning Web Security
To successfully install and use the Avonni Dynamic Components Package, you MUST enable Lightning Web Security (LWS) in your org.
Go to Setup > Security & Privacy.
Locate Lightning Web Security.
Ensure the toggle is Enabled
Direct Link Install
Visit the Release Notes site to access direct links to install the Avonni Experience Components App.
Step 1: Assign Package Licenses
The package license grants the user the fundamental right to use the Avonni Components within Salesforce.
How to Assign
Navigate to Setup.
Search for Installed Packages.
Locate Avonni Components and click Manage Licenses.
Legacy Note: If you are using the legacy standalone package, look for "Avonni Dynamic Component" (singular).
Click Add Users, select the required users, and click Save.
Step 2: Assign Permission Sets
When you install the Avonni Experience Components package, three specific Permission Sets are automatically added to your Salesforce org.
These permission sets control the level of technical access a user has—determining whether they can simply view a component on a page or build new configurations using the Avonni Builder
Select the permission set that matches the user's role:
Role
Permission Set Name
Function
End Users
(Internal Salesforce)
Avonni Dynamic Components User
Required for users who need to view/interact with Dynamic Components (e.g., custom Data Tables, action buttons) inside Salesforce.
End Users
(Experience Cloud)
Avonni Experience Cloud Components User
Required for users who need to view/interact with components on Experience Sites or standard Lightning App Builder pages.
Admins & Builders
Avonni Experiences Admin
Required for users who need to create, edit, or build layouts using the Avonni Component Builder.
How to Assign
Navigate to Setup > Permission Sets.
Select the appropriate Permission Set from the table above.
Click Manage Assignments > Add Assignment.
Select the users to whom you assigned licenses in Step 1.
Click Assign.
Best Practice (Least Privilege): Only assign the Avonni Experiences Admin permission set to users who actually need to build components. Most users only require the User permission sets.
Advanced: Allowing Non-Admins to Build Components
By default, only System Administrators can create/edit components. If you wish to grant a non-admin user the ability to create Dynamic Components, you must assign them the Avonni Experiences Admin permission set (Step 2) AND grant two specific system permissions.
Required System Permissions
Author Apex: Allows creation/modification of custom components.
Modify Metadata Through Metadata API Functions: Enables saving component configurations.
How to configure
Go to Setup > Permission Sets.
Create a New Permission Set (e.g., "Avonni Builder System Permissions").
Go to System Permissions and check the boxes for Author Apex and Modify Metadata Through Metadata API Functions.
Assign this custom permission set to your non-admin builder.
Purchasing Licenses
The Avonni Components package has a freemium plan that allows up to 10 users in your production org. You'll need additional licenses to grant access to more than 10 users.
To purchase licenses, please email us at [email protected] with your requirements or schedule a time to discuss pricing options.
Need Help?
If you are encountering issues with license assignment or permissions:
Community: Join our Trailblazer Community Group to discuss best practices, bulk assignment, and large-org strategies.
Support: Contact our team at
[email protected].Sales: For pricing discussions or high-volume licensing, contact
[email protected].
Last updated
Was this helpful?