> ## 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>