> For the complete documentation index, see [llms.txt](https://docs.avonnicomponents.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.avonnicomponents.com/lwc-components/getting-started/installation-and-licenses-management.md).

# Installation & Licenses Management

Before you can use the Avonni LWC Components in your own Lightning Web Components, you need to install the package in your Salesforce org.

## Install from Salesforce AppExchange

1. **Navigate to AppExchange** — Go to the Salesforce AppExchange, or click the App Launcher in Salesforce and search for "AppExchange".
2. **Find Avonni** — Search for the Avonni LWC Components in the AppExchange marketplace, or open the listing directly below.
3. **Install the package** — Click **Get It Now** and follow the installation prompts.
4. **Choose installation options:**
   * **Install for Admins Only** (recommended for initial setup)
   * **Install for All Users** (after testing and configuration)
5. **Complete installation** — Review and accept the package permissions, then click **Install**.

{% embed url="<https://appexchange.salesforce.com/appxListingDetail?listingId=a0N4V00000FiERkUAN>" %}
View the Avonni LWC Components listing on AppExchange
{% endembed %}

## Post-Installation Setup

### Assign licenses

After installation, assign licenses to the users who will interact with the components:

1. Go to **Setup > Installed Packages**.
2. Find the **Avonni LWC Components** package and click **Manage Licenses**.
3. Assign licenses to the appropriate users.

### Configure permission sets

Assign the permission set included with the package based on user role:

* **Developers** — users who build their own Lightning Web Components on top of the Avonni components.
* **End users** — users who view and interact with apps or pages that include Avonni components.

**Permission set assignment steps:**

1. Go to **Setup > Permission Sets**.
2. Select the appropriate permission set.
3. Click **Manage Assignments**.
4. Click **Add Assignments**.
5. Select the users who need access.
6. Click **Assign**.

## Verify Installation

Confirm the package installed correctly:

1. Go to **Setup > Installed Packages**.
2. Confirm **Avonni LWC Components** appears in the list.

Once it's listed, you can reference any Avonni component in your own code.

## Accessing Avonni Components

You access the Avonni components through your own **custom LWC code**. Once the package is installed, reference any component in your Lightning Web Component's HTML template using the `avonni` namespace prefix — no JavaScript import is required for the markup:

```html
<!-- myComponent.html -->
<template>
    <avonni-avatar
        primary-text="Jane Cooper"
        secondary-text="Product Designer"
        fallback-icon-name="standard:user"
        size="x-large"
        variant="circle"
    ></avonni-avatar>
</template>
```

Pass data and handle events from your component's JavaScript as usual:

```js
// myComponent.js
import { LightningElement } from 'lwc';

export default class MyComponent extends LightningElement {
    handleActionClick(event) {
        // react to component events
    }
}
```

Each component's tag, attributes, events, and a copy-paste example are documented under [Core Components](/lwc-components/core-components/core-components.md) and [Data Driven Components](/lwc-components/data-driven-components/data-driven-components.md).

## Need help with installation?

If you run into issues during installation or setup:

* Check the [Troubleshooting & FAQs](https://docs.avonnicomponents.com) guide for common solutions.
* Join the Trailblazer Community Group, where admins share installation tips and solutions.
* Contact support at <support@avonni.app>.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.avonnicomponents.com/lwc-components/getting-started/installation-and-licenses-management.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.