# 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:

1. [**Assign a Package License**](#step-one-assigning-licenses).
2. [**Assign the Permission Set**](#step-two-assigning-permission-sets)**.**

{% hint style="warning" %}

#### 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
{% endhint %}

***

## Installation

* **Production/Sandbox**: Install the [**Avonni Flow Screen Components Package**](https://appexchange.salesforce.com/listingDetail?listingId=a0N4V00000IDsfbUAD\&tab=e) 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 <sales@avonni.app>.

{% embed url="<https://appexchange.salesforce.com/appxListingDetail?listingId=a0N4V00000IDsfbUAD>" %}

***

## Step One: Assigning Licenses

Licenses allow the package to run in your org.

1. Go to **Setup** and search for **Installed Packages**.
2. Find **Avonni Flow Components** and click **Manage Licenses**.
3. Click **Add Users**.
4. Select the users who need access to flows that contain Avonni Components, thencontaining Avonni Components and click Add.

<figure><img src="https://27923732-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1FUd4apB9YHgCEMUFbVb%2Fuploads%2FQOn8DeRKQOWCzk9yH97w%2F2026-01-14_16-00-10.png?alt=media&#x26;token=76c639bb-f160-48cd-96e9-fc632606e86e" alt=""><figcaption></figcaption></figure>

***

## Step Two: Assigning Permission Sets

Permission sets grant users the actual technical permissions to view the components and fetch data via APIs.

1. Go to **Setup** and search for **Permission Sets**.
2. Click on **Avonni Flow Screen Components**.
3. Click **Manage Assignments** and then **Add Assignments**.
4. Select the same users you licensed in Step One and click **Assign**.

<figure><img src="https://27923732-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1FUd4apB9YHgCEMUFbVb%2Fuploads%2F7rrPiEZ7cSPZJpAWoVrT%2F2023-12-13_11-28-00.png?alt=media&#x26;token=65b2b5b1-20e8-424f-9194-63c4e910a49f" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}

#### 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](https://automationchampion.com/2022/03/17/auto-assign-package-license-to-new-users/).
{% endhint %}

***

## Guest User Access (Experience Cloud)

{% hint style="warning" %}
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](mailto:experiencecomponents@avonni.app) to learn more about this add-on.
{% endhint %}

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."

<figure><img src="https://27923732-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1FUd4apB9YHgCEMUFbVb%2Fuploads%2FeU0ikrRky7UDpTtBkZl9%2F2024-06-10_13-20-14.png?alt=media&#x26;token=ab38d731-6376-40d7-98ec-4d30b7f936f5" alt=""><figcaption></figcaption></figure>

* **API Access**: In the site Administration menu, go to Preferences and check "Allow guest users to access public APIs."

<figure><img src="https://27923732-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1FUd4apB9YHgCEMUFbVb%2Fuploads%2FrtAubQp1yTt51HERqCjY%2F2024-06-10_13-21-12.png?alt=media&#x26;token=cbcaa268-6e93-4e95-8a0f-06af81b99b1e" alt=""><figcaption></figcaption></figure>

### **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.

<figure><img src="https://27923732-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1FUd4apB9YHgCEMUFbVb%2Fuploads%2FYhzPs9XVGCcvIZ5Y2fd2%2F2024-06-10_13-25-53.png?alt=media&#x26;token=271a2758-54a7-460c-b631-9267865d5467" alt=""><figcaption></figcaption></figure>

* **Enable Flow Access**: Scroll down to the Enabled Flow Access section (or use the search bar in the Enhanced Profile User Interface).

<figure><img src="https://27923732-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1FUd4apB9YHgCEMUFbVb%2Fuploads%2FXpzIcNK2dDTklCLWTK2a%2F2024-06-10_13-26-47.png?alt=media&#x26;token=ea08f8db-10bd-4828-a0b9-984347aec3d8" alt=""><figcaption></figcaption></figure>

* **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**.

<figure><img src="https://27923732-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1FUd4apB9YHgCEMUFbVb%2Fuploads%2FZvLxdgzT8z5hsnIr4cCd%2F2024-06-10_13-33-32.png?alt=media&#x26;token=573d66dc-6f56-4a73-8f5b-c0eabb177ef1" alt=""><figcaption></figcaption></figure>

* Click **Manage Assignments** and click Add Assignment.
* **Select the Guest User**: Ensure you select the specific Guest User account associated with your site.

<figure><img src="https://27923732-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1FUd4apB9YHgCEMUFbVb%2Fuploads%2FbUiRmyoECJZZTEGY9a5u%2F2024-06-10_13-36-04.png?alt=media&#x26;token=31c9ee17-aaaa-4b93-a113-336c864aeccf" alt=""><figcaption></figcaption></figure>

### **Publish Changes**&#x20;

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

<table><thead><tr><th>Issue</th><th width="226.3779296875">Likely Cause</th><th>Solution</th></tr></thead><tbody><tr><td><strong>"Insufficient Privileges" or Error Message inside the flow.</strong></td><td>Missing License.</td><td>Go to Setup > Installed Packages > Manage Licenses and ensure the user is added.</td></tr><tr><td><strong>Component visible but data not loading (e.g., Query or Data Table issues).</strong></td><td>Missing Permission Set.</td><td>Assign the Avonni Flow Screen Components Permission Set to the user.</td></tr><tr><td><strong>Guest users see an empty space where the flow should be.</strong></td><td>Profile Flow Access.</td><td>Ensure the specific flow is added to the Enabled Flow Access list on the Guest User Profile.</td></tr><tr><td><strong>Components fail to load on public sites only.</strong></td><td>Public API Access.</td><td>In Experience Site Administration, ensure "Allow guest users to access public APIs" is checked.</td></tr><tr><td><strong>"License Limit Reached" error during assignment.</strong></td><td>Out of Freemium licenses.</td><td>You have used all 10 free production licenses. Contact <a href="mailto:sales@avonni.app">sales@avonni.app</a> to upgrade.</td></tr></tbody></table>

#### Still having trouble?

If you have verified both the **License** and the **Permission Set** and are still experiencing issues:

1. **Check the Browser Console**: Look for any 403 or "Access Denied" errors.
2. **Production Refresh**: If you recently refreshed a sandbox, remember that license assignments may need to be re-verified (though Sandboxes generally use Site Licenses).
3. **Contact Support**: Reach out to our technical team at <support@avonni.app> with a screenshot of the error.