---
title: "Overview"
description: "Learn how to share agent templates across tenants and users"
---

# Sharing Agents

Agent sharing enables you to distribute agent templates to other tenants or users for their own building and customization journey. Whether collaborating with your team, delivering solutions to clients, or contributing to the broader community, sharing provides the foundation for others to build upon your work.

<Note>
Looking to give users access to interact with your agent? That's handled through [Agent Interfaces](/building-and-deploying-agents/interface-options/managing-interfaces).
</Note>

## What Gets Shared

When you share an agent, you're sharing the **agent template** - the building blocks others need to create their own version:

- Agent configuration, prompts, and instructions
- Variables and customization options
- Tool integrations and flow logic
- Interface settings and deployment patterns

<Note>
**Security:** Sensitive data stored as credentials is automatically replaced with placeholders. However, you must manually review your agent before sharing to protect:
- Sensitive information in Python code blocks
- Hard-coded values in user-defined tool properties
- Tool configurations that don't utilize credentials for storing sensitive information

</Note>
Recipients will configure their own credentials and data sources, ensuring each deployment remains isolated and secure.

## Sharing Methods

The Airia platform offers two distinct approaches for sharing agent templates, each designed for different distribution needs:

### Direct Sharing
Direct control over template distribution through private links or file export.

**Private Share Links** generate secure, one-time use URLs that expire in 7 days - perfect for quick, tracked sharing with specific individuals. No file downloads required.

**Export to File** creates portable JSON files you can distribute through any method - ideal for offline transfers, backups, air-gapped environments, or when you need complete control over the distribution channel.

[Learn more about Direct Sharing →](./share-directly)

### Community Sharing
Contribute templates to the **public** Airia Community after review.

Make your agent templates available to the entire Airia ecosystem through the Community platform. Templates undergo a review process (typically 5-7 business days) before becoming publicly available to all users.

[Learn more about Community Sharing →](./community-sharing)

## Choosing the Right Method

Select the sharing approach that best fits your use case:

| Method | Use Case | Distribution | Access Control | Best For |
|--------|----------|--------------|----------------|----------|
| **Private Share Links** | Quick, secure sharing | Direct URL | One-time use, expires in 7 days | Sharing with specific individuals or teams |
| **Export to File** | Offline/manual transfer | File download & upload | Manual distribution control | Backups, air-gapped environments, client deliveries |
| **Community Sharing** | Public contribution | Community platform | Public access after review | Sharing with broader community, templates |

## How to Share Your Agent

Access the **Share Template** tab to share your agent:

**From Agents List:**
- Click the action menu (three dots) on the target agent → **Share Template**

**From Agent Studio:**
- Click the **Settings** icon in the top toolbar → **Share Template** tab

<Note>
**Active Version Required:** All exports use your agent's **active published version**. Verify you've published the intended version before sharing.
</Note>

<Tabs>
  <Tab title="Download File">
    Export your agent as a portable JSON file for offline transfers, backups, or distribution through any channel.

    1. Click **Export File (JSON)** on the Download File card
    2. Select **Download** to generate the export package
    3. JSON file downloads to your local system

    <Tip>
    Use **Update Agent Details** to edit your agent's description, tagline, or other information before exporting.
    </Tip>

    [Learn when to use file exports →](./direct-sharing)
  </Tab>

  <Tab title="Private Link">
    Generate a secure URL for quick sharing with specific individuals.

    1. Select **Create Link** to open the export detail experience
    2. Review details of the agent you are preparing to share
    3. Select **Create Link** to generate a unique, secure URL
    4. URL is automatically copied to your clipboard and ready to share

    <Tip>
    Use **Update Agent Details** to edit your agent's description, tagline, or other information before creating a link.
    </Tip>

    <Note>
    Private links expire after 7 days and are one-time use. Track all created links in the Share History table.
    </Note>

    [Learn when to use private links →](./direct-sharing)
  </Tab>

  <Tab title="Submit to Community">
    Make your agent publicly available to the entire Airia ecosystem.

    1. Click **Submit to Community** on the Community card
    2. Review agent details displayed in submission preview
    3. Add notes to reviewer (optional but recommended)
    4. Select country of origin
    5. Select **Submit for Review**

    <Tip>
    Use **Update Agent Details** to edit your agent's description, tagline, or other information before submitting.
    </Tip>

    <Note>
    Submissions are reviewed within **5-7 business days**. All communication occurs via email.
    </Note>

    [Learn about community requirements →](./community-sharing)
  </Tab>
</Tabs>

## Reviewing Share History

The **Share History** table at the bottom of the Share Template tab displays all previously created links and community submissions. Use this to:

- Track which links are active, expired, or redeemed
- Monitor community submission status
- Deactivate unused private links
- Maintain an audit trail of all sharing activity

## Frequently Asked Questions

<AccordionGroup>
  <Accordion title="Can recipients modify the agent template I share?">
    Yes, that's the purpose of sharing agent templates. Recipients import the template into their own environment where they have complete control to:
    - Modify prompts and instructions
    - Adjust variables and configurations
    - Connect their own tools and data sources
    - Deploy with their own credentials

    Your original agent remains unchanged. Each import creates an independent copy in the recipient's environment.
  </Accordion>

  <Accordion title="What should I do if my export or share fails?">
    If you encounter issues when exporting or sharing an agent:

    1. **Verify Published Agent Version** - All sharing is performed based on the actively published agent version. If the steps don't appear as expected, verify you have published the intended version.

    2. **Check for Unsupported Features** - We're continually expanding supported features. If specific functionality isn't yet supported for export, you'll receive a notification

    If problems persist, contact support with details about the agent and any error messages received. We're continuously improving export capabilities based on user feedback.
  </Accordion>

  <Accordion title="How do I give users access to interact with my agent without sharing the template?">
    If you want users to interact with your agent (chat, submit requests, etc.) rather than receiving the template for building, use [Agent Interfaces](/building-and-deploying-agents/interface-options/managing-interfaces) instead.

    Interfaces allow you to expose agent functionality through:
    - Chat interfaces for direct conversations
    - API endpoints for programmatic access
    - Slack bots, browser extensions, and other deployment methods

    With interfaces, users interact with YOUR deployed agent - they don't receive a copy of the template.
  </Accordion>

  <Accordion title="I have multiple agents in my solution. Do I need to submit them all?">
    It depends on how your agents are structured:

    - **Multi-agent system with a parent agent** - If your solution uses one parent agent with other agents nested inside it, you only need to submit the parent agent. All nested agents are included automatically.
    - **Separate, standalone agents** - If your agents are independent and called from an external application outside of Airia, each agent needs to be submitted separately.
  </Accordion>

  <Accordion title="How can I help others understand my agent when they receive it?">
    Make your agent template easy to understand and customize by documenting it properly:

    **Annotations (Notes) on the Canvas** - Add notes directly to your agent canvas to guide recipients:
    - Explain the purpose of specific sections or logic flows
    - Highlight setup requirements or dependencies
    - Call out areas that need customization
    - Provide context for complex decision points

    **Agent Description** - Use the Description field in your agent's settings (supports rich text formatting) to document:
    - Overall purpose and use cases
    - Required credentials or integrations to configure
    - Variables that should be customized
    - Expected behavior and example interactions
    - Any limitations or special considerations

    Well-documented agents are more likely to be successfully adopted and customized by recipients.
  </Accordion>
</AccordionGroup>
