# Folders

## Folders: Organizing Your Dynamic Components

As your library of Avonni Dynamic Components grows, keeping them organized becomes essential. The **Folders** feature provides a simple yet powerful way to categorize, manage, and quickly locate your components directly within the Avonni Dynamic Components App.

## Creating and Managing Folders

You can create, customize, and delete folders to suit your organizational needs.

### Creating a New Folder

1. **Locate "New Folder" Option:** In the Folders panel on the left, look for a button or icon to create a new folder (e.g., a "+" icon next to the Folders heading, or a "New Folder" button).
2. **Enter Folder Name:** Provide a clear and descriptive name for your folder.
3. **Assign a Color (Optional):** You can assign a specific color to the folder for better visual distinction in the folder list.
4. **Save:** Confirm the creation of the folder.

<figure><img src="https://2532358799-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FODPvvv7Cx9Z9RECLn3oV%2Fuploads%2FxsVH9b9hE1qptwl2sEes%2F2025-05-09_15-44-16.png?alt=media&#x26;token=db34a2e0-29e0-4eda-90ae-e88539a437f8" alt=""><figcaption></figcaption></figure>

### Editing Folder Properties (Renaming, Changing Color)

1. **Select the Folder:** Find the folder you wish to edit in the Folders panel.
2. **Access Edit Options:** Click on the Edit Button located at the top right corner associated with that folder.
3. **Modify:** Choose options like "Rename Folder" or "Change Color" and make your desired adjustments.
4. **Save Changes.**

<figure><img src="https://2532358799-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FODPvvv7Cx9Z9RECLn3oV%2Fuploads%2FY7ASCRMGBRxIPTPVGK3k%2F2025-05-09_15-45-33.png?alt=media&#x26;token=b5e57c2c-a1aa-4b8e-ad9a-aa7c35f7efd6" alt=""><figcaption></figcaption></figure>

### Deleting a Folder

Deleting a folder is a multi-step process because Dynamic Components (and likely folders themselves) are stored as Custom Metadata Types in Salesforce.

1. **Select the Folder to Delete:** In the Folders panel within the Avonni app, identify the folder you want to remove.
2. **Initiate Deletion from Avonni App:** Use the action menu for that folder and select the "Delete Folder" option.
3. **Redirection to Salesforce Setup**
   * **Important:** Clicking "Delete" in the Avonni App will **redirect you** to the corresponding Custom Metadata Type record page for that folder within **Salesforce Setup**. This is a necessary step because the final, permanent deletion must occur through standard Salesforce mechanisms.
4. **Confirm Deletion in Salesforce Setup**
   * On the Custom Metadata Type record page you were redirected to, click the standard Salesforce **"Delete"** link/button.
   * Confirm the deletion when prompted by Salesforce. The deletion is not effective until this Salesforce step is completed.

<figure><img src="https://2532358799-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FODPvvv7Cx9Z9RECLn3oV%2Fuploads%2FqYwer6sjq3dAArPpNWPm%2F2025-05-09_15-46-26.png?alt=media&#x26;token=0060f43d-611c-4c27-bc61-997cad1f0b2d" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
**What Happens to Components When a Folder is Deleted?**

* Deleting a folder **WILL NOT delete the Dynamic Components** assigned to it.
* Instead, it will simply **remove the assignment** of those components to the folder you are deleting. The components will still exist (likely appearing as "unfiled" or in any other folders they might be assigned to).
  {% endhint %}

## Assigning Components to Folders

You can assign a Dynamic Component to one or multiple folders during its creation or by editing it later.

### During New Component Creation

1. When you click "New" to create a Dynamic Component from the Avonni Components App home page, the creation dialog will include an option to **assign it to folders**.
2. You can select one or more existing folders to associate with your new component.

<figure><img src="https://2532358799-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FODPvvv7Cx9Z9RECLn3oV%2Fuploads%2FY2XbaN1HWMAJYcHWQZv3%2F2025-05-09_15-47-58.png?alt=media&#x26;token=3fe5f791-176b-49f4-b312-5ac991efa91b" alt=""><figcaption></figcaption></figure>

### For Existing Components (from Component Builder Settings)

1. Open the Dynamic Component you wish to assign to a folder in the **Component Builder**.
2. Click the **Settings** icon (usually a gear ⚙️ in the top-left).
3. In the settings panel, find the section for **Folder Assignments** (or similar).
4. Here, you can add or remove the component's association with existing folders. You can typically assign a component to multiple folders if needed.
5. **Save** your Dynamic Component changes.

<figure><img src="https://2532358799-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FODPvvv7Cx9Z9RECLn3oV%2Fuploads%2FiRzMvpzITsjPeCrN1HfC%2F2025-05-09_15-48-43.png?alt=media&#x26;token=887cb842-e75e-4a74-90a9-bb959c20fbc5" alt=""><figcaption></figcaption></figure>

### Adding Components to a Folder (from Folder View)

1. **Select a Folder:** In the Folders panel on the Avonni Dynamic Components app home page, click on the folder to which you want to add existing components.
2. **Find "Add Component" Button:** Look for an "Add Component" button within the view of the selected folder's contentsWithin the view of the selected folder's contents, look for an "**Add Component**" button (or similar).
3. **Select Components:** Clicking this button will likely open a list or search interface allowing you to select one or more existing Dynamic Components to assign to the currently viewed folder.
4. **Confirm Assignment.**

<figure><img src="https://2532358799-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FODPvvv7Cx9Z9RECLn3oV%2Fuploads%2FLYj18slaTRgjo17NfLhI%2F2025-05-09_15-50-46.png?alt=media&#x26;token=9fca762b-bda6-4aee-8eac-a21bededc1a8" alt=""><figcaption></figcaption></figure>

## Key Considerations

* **Organizational Tool:** Folders are primarily for organization and do not typically enforce security or sharing rules (Salesforce profiles, permission sets, etc. still handle these).
* **Multiple Folders:** A single Dynamic Component can often be assigned to multiple folders if that suits your organizational structure.
* **Deleting Folders vs. Components:** Deleting a folder only removes the organizational tag; it does not delete the components themselves. Component deletion is a separate process (see Version Management documentation).

## In Summary

The Folders feature in the Avonni Dynamic Components App provides an essential way to keep your custom components organized and easily accessible. By creating a logical folder structure and assigning components appropriately, you can significantly improve your workflow, especially as your library of custom solutions grows
