Installation & Licenses management
Installation & License Management
To ensure Avonni Components function correctly for your users in a Production environment, you must complete two essential steps:
Important
Assigning a license alone is not enough. If a user has a license but lacks the permission set, they will encounter errors when interacting with data components or specific flow features
Installation
Production/Sandbox: Install the Avonni Flow Screen Components Package from the Salesforce AppExchange.
Sandbox Environments: Sandboxes automatically include a Site License. You can test with unlimited users without manual license assignment.
Production Environments: Includes a Freemium plan (10 licenses). For more, contact [email protected].
Step One: Assigning Licenses
Licenses allow the package to run in your org.
Go to Setup and search for Installed Packages.
Find Avonni Flow Components and click Manage Licenses.
Click Add Users.
Select the users who need access to flows that contain Avonni Components, thencontaining Avonni Components and click Add.
Step Two: Assigning Permission Sets
Permission sets grant users the actual technical permissions to view the components and fetch data via APIs.
Go to Setup and search for Permission Sets.
Click on Avonni Flow Screen Components.
Click Manage Assignments and then Add Assignments.
Select the same users you licensed in Step One and click Assign.
Pro Tip
Want to automate this? You can use a Record-Triggered Flow to assign licenses and permission sets automatically whenever a new user is created. View Tutorial.
Guest User Access (Experience Cloud)
Avonni Components can also be used by guest users on Experience Cloud sites, even if they don't have a Salesforce login. This is an optional add-on feature for production orgs that can be incredibly useful for creating public-facing sites and applications.
Contact us to learn more about this add-on.
To use Avonni Components on public-facing sites for users without a Salesforce login, follow these requirements:
Step A: Enable Site & API Access
Site Settings: Ensure your Experience Cloud site is set to "Public."
API Access: In the site Administration menu, go to Preferences and check "Allow guest users to access public APIs."
Step B: Grant Flow Access to the Guest Profile
Navigate to the Guest User Profile: In Salesforce Setup, find the specific Profile associated with your Experience Cloud site.
Enable Flow Access: Scroll down to the Enabled Flow Access section (or use the search bar in the Enhanced Profile User Interface).
Add the Flow: Click Edit, find the specific flow(s) containing Avonni Components, and move them to the Enabled Flows list.
Step C: Assign the Avonni Permission Set
Go to Setup > Permission Sets > Avonni Flow Screen Components.
Click Manage Assignments and click Add Assignment.
Select the Guest User: Ensure you select the specific Guest User account associated with your site.
Publish Changes
Publish your site to make the changes live.
By following these steps, guest users can interact with the Avonni Components embedded in your flows, enhancing the functionality and accessibility of your Experience Cloud site.
Troubleshooting Common Issues
If you or your users encounter issues with Avonni Components, check the following common scenarios
"Insufficient Privileges" or Error Message inside the flow.
Missing License.
Go to Setup > Installed Packages > Manage Licenses and ensure the user is added.
Component visible but data not loading (e.g., Query or Data Table issues).
Missing Permission Set.
Assign the Avonni Flow Screen Components Permission Set to the user.
Guest users see an empty space where the flow should be.
Profile Flow Access.
Ensure the specific flow is added to the Enabled Flow Access list on the Guest User Profile.
Components fail to load on public sites only.
Public API Access.
In Experience Site Administration, ensure "Allow guest users to access public APIs" is checked.
"License Limit Reached" error during assignment.
Out of Freemium licenses.
You have used all 10 free production licenses. Contact [email protected] to upgrade.
Still having trouble?
If you have verified both the License and the Permission Set and are still experiencing issues:
Check the Browser Console: Look for any 403 or "Access Denied" errors.
Production Refresh: If you recently refreshed a sandbox, remember that license assignments may need to be re-verified (though Sandboxes generally use Site Licenses).
Contact Support: Reach out to our technical team at [email protected] with a screenshot of the error.
Last updated
Was this helpful?