> ## Documentation Index
> Fetch the complete documentation index at: https://resources.athenaintel.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Asset Organization

Athena provides three powerful systems for organizing and managing your data: **Folders**, **Collections**, and **Catalogs**. These complementary tools help you structure, group, and connect to various data sources within your workspace.

<CardGroup cols={3}>
  <Card title="Folders" icon="folder">
    Hierarchical organization with parent-child relationships and protected user spaces
  </Card>

  <Card title="Collections" icon="layer-group">
    Group related assets together for thematic or project-based organization
  </Card>

  <Card title="Catalogs" icon="database">
    Connect to external data sources and providers for live access to your data
  </Card>
</CardGroup>

<Tabs>
  <Tab title="Folders">
    Folders in Athena provide a hierarchical structure for organizing your assets, similar to traditional file systems. They support parent-child relationships, allowing you to create nested folder structures that match your organizational needs.

    ### Key Features

    * **Hierarchical Organization**: Create nested folder structures to organize assets logically
    * **User Sandbox**: Each user has a protected sandbox folder (`sandbox/{username}/`) for personal assets
    * **Sharing & Permissions**: Control who can view and edit folder contents
    * **Asset Management**: Move assets between folders with drag-and-drop or bulk operations

    ### Creating Folders

    <Steps>
      <Step title="Create a folder">
        Go to [Spaces](https://app.athenaintel.com/dashboard/spaces/) and click on the **+** icon. Select **Folder** from the menu.

        <Frame>
          <img src="https://mintcdn.com/athenaintelligence-e46bc9d3/aQorAfz9S9NqlSen/images/folder-step1.png?fit=max&auto=format&n=aQorAfz9S9NqlSen&q=85&s=7022d215b979a926d28bb985ca90d435" width="950" height="514" data-path="images/folder-step1.png" />
        </Frame>
      </Step>

      <Step title="Name your folder">
        Give your folder a descriptive name and click on **Create Folder**.

        <Frame>
          <img src="https://mintcdn.com/athenaintelligence-e46bc9d3/aQorAfz9S9NqlSen/images/folder-step2.png?fit=max&auto=format&n=aQorAfz9S9NqlSen&q=85&s=670379f57348df49d117955df939aa7d" width="3456" height="1978" data-path="images/folder-step2.png" />
        </Frame>
      </Step>

      <Step title="Organize Assets">
        Drag and drop assets into your folder, or use the context menu to move multiple assets at once.

        <Frame>
          <img src="https://mintcdn.com/athenaintelligence-e46bc9d3/aQorAfz9S9NqlSen/images/folder-step3.png?fit=max&auto=format&n=aQorAfz9S9NqlSen&q=85&s=c6179d83a670eb28c097282afbbe145a" width="1696" height="1340" data-path="images/folder-step3.png" />
        </Frame>
      </Step>
    </Steps>

    ### Folder Structure

    Folders can contain:

    * **Assets**: Documents, sheets, notebooks, and other file types
    * **Subfolders**: Create nested hierarchies for complex organization
    * **Live Assets**: Files from external providers like SharePoint or Google Drive

    <Tip>Your personal sandbox folder is automatically created and provides a private space for your assets. Other users cannot access your sandbox unless you explicitly share assets from it.</Tip>
  </Tab>

  <Tab title="Collections">
    Collections allow you to group related assets together without changing their folder location. Think of collections as custom tags or playlists for your assets - an asset can belong to multiple collections while remaining in its original folder.

    ### Key Features

    * **Asset Grouping**: Combine assets from different folders into a single view
    * **Descriptions**: Add rich text descriptions to document the collection's purpose
    * **Dynamic Membership**: Easily add or remove assets without affecting their original locations
    * **Multiple Collections**: Assets can belong to multiple collections simultaneously

    ### Creating Collections

    <Steps>
      <Step title="Access Collection Creator">
        From Spaces, click the **+** icon and select **New Collection**.

        <Frame>
          <img src="https://mintcdn.com/athenaintelligence-e46bc9d3/1K9JaBoqyAQssL9u/images/collection-step1.png?fit=max&auto=format&n=1K9JaBoqyAQssL9u&q=85&s=94e543f004c3856fa06c559360a75efb" width="856" height="574" data-path="images/collection-step1.png" />
        </Frame>
      </Step>

      <Step title="Name and Describe">
        Give your collection a meaningful name and add a description explaining its purpose or contents.

        <Frame>
          <img src="https://mintcdn.com/athenaintelligence-e46bc9d3/JOia5pER8hEU2s7U/images/collection-step2.png?fit=max&auto=format&n=JOia5pER8hEU2s7U&q=85&s=2da7818f8aac30b931210f98a698206e" width="3456" height="1980" data-path="images/collection-step2.png" />
        </Frame>
      </Step>

      <Step title="Add Assets">
        Click **Add Assets** to select items from your workspace. You can add assets from any folder you have access to.
        <Tip>Note that you can add files directly from your SharePoint by switching to the SharePoint asset selector.</Tip>

        <Frame>
          <img src="https://mintcdn.com/athenaintelligence-e46bc9d3/JOia5pER8hEU2s7U/images/collection-step3.png?fit=max&auto=format&n=JOia5pER8hEU2s7U&q=85&s=ff66f4ef9f33bc44687ab0dd3414b6f0" width="2160" height="798" data-path="images/collection-step3.png" />
        </Frame>

        <br />

        <Frame>
          <img src="https://mintcdn.com/athenaintelligence-e46bc9d3/JOia5pER8hEU2s7U/images/collection-step4.png?fit=max&auto=format&n=JOia5pER8hEU2s7U&q=85&s=28d362b184d05d24f854967003225b63" width="3456" height="1982" data-path="images/collection-step4.png" />
        </Frame>
      </Step>

      <Step title="Manage Contents">
        View and interact with all assets in the collection. Use the **\[...]** menu for additional options or click **X** to remove assets.

        <Frame>
          <img src="https://mintcdn.com/athenaintelligence-e46bc9d3/JOia5pER8hEU2s7U/images/collection-step5.png?fit=max&auto=format&n=JOia5pER8hEU2s7U&q=85&s=af940891ef1947b444a83b344dac9bf5" width="3456" height="1986" data-path="images/collection-step5.png" />
        </Frame>
      </Step>
    </Steps>

    ### Working with Collections

    Collections display:

    * **Asset List**: All assets in the collection with their types and metadata
    * **Description**: Rich text explanation of the collection's purpose
    * **Quick Actions**: Add new assets, remove items, or refresh the view
    * **Asset Preview**: Click any asset to view it without leaving the collection

    <Tip>Collections are perfect for organizing assets across folder boundaries. For example, create a collection of all Q4 reports even though they're stored in different department folders.</Tip>
  </Tab>

  <Tab title="Catalogs">
    Catalogs provide connections to external data sources, enabling you to access data without importing it into Athena. There are two types of catalogs: **Database Catalogs** for structured data sources and **Live Asset Catalogs** for external file providers.

    ### Database Catalogs

    Database catalogs connect to structured data sources like Snowflake, BigQuery, PostgreSQL, or other SQL databases. They provide a hierarchical view of your data: **Catalog → Schema → Table → Columns**.

    #### Features

    * **Schema Browser**: Navigate database schemas and tables visually
    * **Query Integration**: Use catalogs with [Query Snippets](https://resources.athenaintel.com/docs/pillars/applications/query) to analyze data
    * **Column Information**: View column names, types, and metadata
    * **Real-Time Access**: Query live data without copying it into Athena

    #### Database Catalog Structure

    ```
    Catalog (e.g., "production_db")
    ├── Schema (e.g., "sales")
    │   ├── Table (e.g., "orders")
    │   │   ├── Column: order_id
    │   │   ├── Column: customer_id
    │   │   └── Column: total_amount
    │   └── Table (e.g., "customers")
    └── Schema (e.g., "inventory")
    ```

    <Tip>Use fully qualified names when querying: `catalog_name.schema_name.table_name` to ensure accurate results.</Tip>

    ### Live Asset Catalogs

    Live asset catalogs connect to external providers like SharePoint, Google Drive, Gmail, and ServiceNow. They enable you to access and work with files that remain in their original locations.

    <Tip>Learn how to connect your SharePoint to Athena [here](https://resources.athenaintel.com/docs/connect-your-data/sharepoint)!</Tip>

    #### Supported Providers

    * **SharePoint**: Sites, document libraries, files, and folders
    * **Google Drive**: Files and folder structures
    * **Gmail**: Email messages and attachments
    * **ServiceNow**: Catalogs and records
    * **More providers**: Additional integrations available through Paragon

    #### Features

    * **Real-Time Sync**: Access the current state of external files
    * **No Migration Required**: Files stay in their original systems
    * **Unified Interface**: Work with external assets alongside native Athena assets
    * **Multi-User Support**: Team members can connect to shared catalogs independently
  </Tab>
</Tabs>
