# New Navigation Item Collection

## **Overview**

The New Navigation Item Collection is designed to simplify and streamline the management of navigation menus within your Salesforce screen flows. By defining a centralized collection of navigation items, you can easily reuse them across multiple Avonni Navigation components, ensuring consistency and reducing redundancy in your flow designs.

## **Key Benefits**

* **Centralized Navigation Management:** Create and maintain a single source of truth for navigation items, eliminating the need to replicate configuration across multiple components.
* **Enhanced Reusability:** Apply the same navigation structure across screens or flows, saving development time and effort.
* **Improved Consistency:** Ensure a uniform navigation experience for users throughout your application.
* **Simplified Maintenance:** Update navigation items in one place, and changes automatically propagate to all linked Avonni Navigation components.

## **How It Works**

1. **Drag and Drop:** From the Avonni Actions section in Flow Builder, locate the New Navigation Item Collection and drag it onto your canvas (outside of any specific screen element).
2. **Define Navigation Items:** You'll see a list of navigation items within the Action Collection's properties. For each item, configure the following settings:
   * **Label:** The text is displayed to the user in the navigation menu.
   * **Icon Name:** (Optional) Select an icon from the available library to represent the navigation item visually.
   * **Sub Items:** (Optional) Create nested navigation items (submenus) for more complex navigation structures.
   * **Unselectable (Toggle):** (Optional) If enabled, this item acts as a heading and cannot be directly selected by the user.
   * **Value:** A unique identifier for the navigation item, used for programmatic control or to track user selections.
   * **Tag:** (Optional) A custom tag for categorizing or filtering navigation items.
   * **Tooltip:** (Optional) Provide additional information that appears when the user hovers over the navigation item.
3. **Link to Avonni Navigation Components:** In your Avonni Navigation components, reference the ID of the New Navigation Item Collection you've created. This will dynamically populate the navigation menu based on your defined items.

## **Settings and Options**

* **Label:** Descriptive text for the navigation item.
* **Icon Name:** Visual representation (optional).
* **Sub Items:** Define nested navigation structures.
* **Unselectable (Toggle):** Create non-clickable heading items.
* **Value:** Unique identifier for the item.
* **Tag:** Custom categorization or filtering.
* **Tooltip:** Additional information on hover.

## **Integration with Avonni Navigation Component**

The New Navigation Item Collection is designed to work with the [Avonni Navigation component](https://docs.avonnicomponents.com/flow/flow-components/navigation). Once your collection is defined, you can easily reference it within multiple Avonni Navigation components, ensuring a unified navigation experience across your application.

**Example Use Cases**

* **Global Navigation:** Create a primary navigation menu for your application on every screen.
* **Contextual Navigation:** Define navigation items relevant to your flow's specific screen or section.
* **User Profile Menus:** Build a dropdown menu accessible from a user's avatar that includes actions like profile settings, logout, etc