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

# Bundles

> Package agents and prompts into a single, shareable, reusable toolkit on the Swarms Marketplace

A **Bundle** is a curated collection of agents and prompts, packaged together into one shareable toolkit. Instead of sharing a dozen scattered links, you assemble your best agents and prompts—plus your own custom prompts—into a single product that anyone can access, bookmark, and reuse with one click.

Bundles are a first-class marketplace product type, sitting alongside [Agents and Prompts](/docs/marketplace/agents-vs-prompts). They add a layer of human curation on top of the marketplace: pre-assembled solution kits for a specific use case.

***

## What Is a Bundle?

Bundles are **meta-products**—they aggregate other items into a themed collection. A single bundle can combine:

<CardGroup cols={2}>
  <Card title="Marketplace Agents" icon="robot">
    Reference any existing agent by its marketplace URL. The bundle automatically enriches it with the agent's real name and description.
  </Card>

  <Card title="Marketplace Prompts" icon="message-lines">
    Reference any existing prompt from the marketplace the same way, pulling in its live details.
  </Card>

  <Card title="Custom Prompts" icon="pen-to-square">
    Write your own inline prompts—name, description, and prompt content—without publishing them as standalone listings.
  </Card>

  <Card title="Related Links" icon="link">
    Add optional supporting links such as docs, GitHub repos, or demos in a dedicated sidebar.
  </Card>
</CardGroup>

<Note>
  Every bundle requires at least one item. Bundles are **free to create** and free for others to access.
</Note>

***

## How to Launch a Bundle

Launching a Bundle takes less than a minute.

<Note>
  Prefer code over clicks? Bundles can also be published programmatically via the [Bundles API](/docs/marketplace/bundles-api) (`POST /api/v1/publish/bundle`).
</Note>

<Steps>
  <Step title="Sign Up">
    Create an account or sign in at [swarms.world/signin](https://swarms.world/signin).
  </Step>

  <Step title="Go to Publish">
    Navigate to [swarms.world/publish](https://swarms.world/publish).
  </Step>

  <Step title="Select Bundle">
    Choose **"Bundle"** as your product type.
  </Step>

  <Step title="Add Bundle Details">
    Give your bundle a name (min. 2 characters) and a description (min. 10 characters). Add comma-separated tags—or let the platform auto-generate them—and upload a cover image (images, GIFs, and video files are supported).
  </Step>

  <Step title="Add Your Items">
    Build the toolkit by adding items in either of two ways:

    * **Marketplace URL** — paste a link to an existing agent or prompt
    * **Custom Prompt** — write a prompt inline with its own name, description, and content

    Add as many as you like. Optionally include **Related Links** (docs, GitHub, etc.).
  </Step>

  <Step title="Publish">
    Hit **Publish**. Your bundle gets its own public page, and you're redirected to it.
  </Step>
</Steps>

That's it. Your entire toolkit is now packaged into one reusable, discoverable Bundle.

***

## Sharing and Growing Your Bundle

Every bundle is built to spread. Once published, it grows through marketplace-native discovery.

<CardGroup cols={2}>
  <Card title="One-Click Share Link" icon="share-nodes">
    Each bundle has its own public page at `swarms.world/bundle/{id}` and a **Share Link** button that copies the URL to your clipboard. Drop it anywhere.
  </Card>

  <Card title="Marketplace Discovery" icon="store">
    Bundles appear in the dedicated **Bundles** section of the marketplace and can be filtered as their own category.
  </Card>

  <Card title="Creator Profile" icon="user">
    Every bundle you publish is listed under the **Bundles** tab on your creator profile, building your portfolio.
  </Card>

  <Card title="Bookmarks" icon="bookmark">
    Other users can bookmark your bundle to their personal collection for quick access later.
  </Card>

  <Card title="Ratings & Reviews" icon="star">
    Bundles collect ratings and reviews, giving them built-in social proof and credibility.
  </Card>

  <Card title="Comments & Discussion" icon="comments">
    Each bundle page has a discussion section where users can ask questions and leave feedback.
  </Card>
</CardGroup>

<Tip>
  Bundles include full SEO support—Open Graph tags, Twitter cards, and schema.org structured data—so shared links render rich previews on social platforms and rank in search.
</Tip>

***

## Why Use Bundles?

Bundles keep everything in one place. Instead of sharing a dozen scattered links, you package agents and prompts into a single, reusable toolkit that anyone can access with one click.

* **One link, not ten** — distribute an entire workflow as a single product.
* **Context stays together** — agents and prompts that were meant to work as a set ship as a set.
* **Built-in credibility** — ratings, reviews, and bookmarks travel with the bundle.
* **Build once, share everywhere** — a reusable asset you assemble a single time.
* **Free to create** — no cost to publish or to access.

***

## When to Use Bundles

Reach for a bundle whenever you want to package and distribute expertise:

| Use Case | Example |
| - | - |
| **Research stacks** | A collection of research, summarization, and citation agents and prompts. |
| **Trading toolkits** | Market-analysis agents paired with strategy prompts. |
| **Customer support workflows** | Triage, response, and escalation prompts in one kit. |
| **Team onboarding kits** | A vetted set of tools to get new teammates productive fast. |
| **Educational courses** | Package the tools behind a tutorial or course in one place. |
| **Showcase collections** | Curate and highlight your best work on your profile. |

***

## Bundles vs. Agents and Prompts

| Feature | Bundles | Agents | Prompts |
| - | - | - | - |
| **Contains** | Agents + prompts + custom prompts | Executable code | System prompt template |
| **Purpose** | Curated toolkit / collection | Autonomous AI logic | Behavior instructions |
| **Pricing** | Free only | Free or paid | Free or paid |
| **Shareable page** | ✅ | ✅ | ✅ |
| **Ratings & reviews** | ✅ | ✅ | ✅ |
| **Bookmarks** | ✅ | ✅ | ✅ |

<Note>
  Bundles are currently **free-only**. The underlying platform has groundwork for future monetization, but pricing controls are not yet enabled for bundles.
</Note>

***

## Next Steps

<CardGroup cols={2}>
  <Card title="Launch a Bundle" icon="rocket" href="https://swarms.world/publish">
    Head to the publish page and select "Bundle" to get started.
  </Card>

  <Card title="Bundles API" icon="code" href="/docs/marketplace/bundles-api">
    Publish bundles programmatically with your API key.
  </Card>

  <Card title="Agents vs Prompts" icon="scale-balanced" href="/docs/marketplace/agents-vs-prompts">
    Understand the building blocks you'll add to your bundles.
  </Card>

  <Card title="Share & Discover" icon="compass" href="/docs/marketplace/share_and_discover">
    Learn more about discovery and sharing across the marketplace.
  </Card>

  <Card title="Monetize Your Work" icon="dollar-sign" href="/docs/marketplace/monetize">
    Explore how creators earn on the Swarms Marketplace.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.