# Marketplace

The Marketplace is where people share bots they've set up, so you can add a ready-made bot instead
of writing one from scratch.

Open the account menu (your avatar at the bottom of the sidebar), choose **Workspace tools**, then
**Marketplace**. On mobile, choose **Marketplace** in the account screen.

## Find a bot

- **All** shows every published bot, with **Featured** picks at the top.
- **From Opisense** shows bots made by Opisense.
- **My submissions** shows the bots you've shared and where each one stands.

Search by a bot's name or its creator, or pick a category to narrow the list.

## Add a bot

Open a bot to see its description, **Instructions**, and any **Skills** and **Routines** it comes
with. Choose **Add bot** and its chat opens, in the [space](/docs/spaces/) you're in.

What you get is your own copy:

- Its skills are added to your [skills](/docs/skills/). If you already have a skill with the same
  name, the copy gets a different name.
- Its [routines](/docs/routines/) arrive **Paused**, with their times in your timezone. Turn one on
  when you're ready. A routine without a schedule says **Set up a trigger after import.**
- Later changes to the listing don't change your copy, and you can edit it like any other bot.

The bot doesn't bring any connected apps or saved credentials. Connect what it needs from
[Integrations](/docs/integrations/).

## Share your bot

1. Choose **Share bot**.
2. Under **Bot**, choose one of your bots. Its name, description, instructions and avatar are filled
   in.
3. Edit anything you don't want to share. Chats, memories, credentials and connected accounts are
   never included.
4. Optionally, add your own skills with **Add skill** and the bot's routines with **Add routine**.
   You can edit or remove each one before sharing. A routine keeps its schedule and starts paused for
   whoever adds it.
5. Enter a **Public creator name**, pick a **Category**, and choose **Submit for review**.

Only what's on this form is shared. Model settings, files, plugin skills and routine triggers such
as webhooks stay with you.

## Review

Every shared bot is reviewed before others can see it. Until then it shows **Pending review** in
**My submissions**. Once approved it shows to everyone; if it's **Rejected**, any note from the
reviewer appears on the listing.

## Update or withdraw a listing

A listing is a snapshot of the bot when you shared it. To share a newer version, choose **Share bot**
again, then withdraw the old listing.

To take a listing down, open it and choose **Withdraw listing**, then confirm. No one can add it
after that, but copies people already added keep working. A withdrawn listing can't be published
again.

<!-- self-hosted -->

## For platform admins

Platform admins (not team owners or admins) see a **Review submissions** view. Open a submission, add a **Review note (optional)**, and
choose **Approve**, **Approve and feature** or **Reject**. Rejecting asks you to confirm first.
**Remove from featured** takes a published bot out of **Featured**.

Bots that platform admins share are published right away with **Publish bot**, and **Publish as Opisense**
lists one under **From Opisense**.

### Opisense's own bots

Opisense comes with a set of ready-made bots for common jobs in every category. To list them under
**From Opisense**, run this on the server, naming a platform admin's account as their owner:

```bash
docker compose -f docker-compose.images.yml exec api node dist/cli/official-bots.js --owner admin@example.com
```

Run it again after an upgrade to get new and improved bots. A bot you withdrew stays withdrawn, and
your **Featured** picks are kept.

<!-- /self-hosted -->
