Plugins
Plugin store
The plugin store is where workspaces find plugins. It lives in two places: Plugins › Store inside every workspace, and the public directory at /plugins that anyone and search engines can open. This page explains the store for people who install plugins and, in depth, the store page for developers who list one.
The public directory
| Page | Address | Shows |
|---|---|---|
| Directory | /plugins | The landing: floating plugins around the search, the category rail, the top three in a spotlight, every listed plugin (sort by Popular, Top rated or Newest, 24 per page), a band for developers and the FAQ. A search, a sort or a later page shows the plain list |
| Category | /plugins/category/<category> | Plugins of one category, with its own heading and description |
| Developer | /plugins/<scope> | Every plugin by one developer (/plugins/acme) |
| Plugin | /plugins/<scope>/<name> | The store page (below) |
Categories: Sales, Marketing, Support, Automation, AI, Payments, Shipping, Analytics, Productivity, Integration.
The directory is open when the platform turns it on; otherwise only the in-workspace store shows.
A store page
| Part | Where it comes from |
|---|---|
| Name, icon, Verified developer badge | The manifest; the badge needs a verified domain and 6 months without strikes |
| Tagline (one line under the name) | description.short |
| Rating, active installs | Workspaces' 1–5 ratings, live installs |
| Cover and gallery | media.cover (1200×630, also the share image) and up to 8 screenshots (1600×1000) or YouTube / Vimeo videos |
| Description | description.long (Markdown) |
| Highlights | Up to 5 selling points |
| Setup steps | Up to 8 steps |
| Price | Free, or the one-time license, and the top-ups it sells |
| What it can do and data safety | From the build: abilities, network hosts, whether it keeps customer records or reads conversations |
| Questions and answers | Up to 10 FAQ entries |
| Works inside / Extensions for | Plugins it extends, and plugins that extend it |
| Similar plugins | Same category |
| Links | Support email and URL, docs, privacy, terms, website, demo (empty links don't show) |
| Notices | This plugin hasn't been updated in over a year when it's stale |
Every store page also has a Markdown copy at /plugins/<scope>/<name>.md for AI answer engines, listed in /llms.txt.
Write a great store page
The store page comes from listing/listing.json in your plugin package (packed into the build by bun run build), or from Store page in the developer portal. Beamvia reviews every change; until then Preview shows the page with your changes, hidden from search engines.
{
"description": {
"short": { "en": "Live courier rates in every chat", "id": "Ongkir real-time di setiap chat" },
"long": { "en": "## What it does\n…", "id": "…" }
},
"highlights": { "en": ["Rates from 20+ couriers", "Waybill in one tap"], "id": ["…"] },
"media": {
"cover": { "url": "cover.png", "alt": { "en": "Shipping rates inside a WhatsApp chat" } },
"gallery": [{ "type": "IMAGE", "url": "01.png", "alt": { "en": "Rates card in the inbox" } }]
},
"faq": [{ "question": { "en": "Which couriers?" }, "answer": { "en": "JNE, J&T, SiCepat…" } }],
"setup": [{ "en": "Install Shipping in your workspace." }, { "en": "Paste your API key in Settings." }],
"categories": ["SHIPPING", "SALES"],
"tags": ["ongkir", "courier"],
"languages": ["en", "id"],
"support": { "email": "[email protected]", "url": "" },
"links": { "docs": "", "privacy": "https://acme.com/privacy", "terms": "", "website": "https://acme.com", "demo": "" },
"seo": { "title": { "en": "Shipping rates for WhatsApp sellers" }, "description": { "en": "…" }, "keywords": ["ongkir whatsapp"] }
}
| Field | Limit |
|---|---|
description.short | 80 characters per language |
description.long | Markdown, 10,000 characters |
highlights | 5, 80 characters each |
media.gallery | 8 (images uploaded, videos YouTube or Vimeo) |
faq | 10 (question 200, answer 1,000 characters) |
setup | 8 steps, 300 characters each |
categories | 1–2 |
tags | 5, 2–30 characters, lowercase |
languages | en, id (at least one) |
seo.title / seo.description | 60 / 160 characters; keywords up to 10 |
Paid plugins need a privacy policy link and a support email.
Tips that sell
- Tagline: the outcome, not the feature (
Live courier rates in every chat). - Long description: what it does, who it's for, how it works, in short sections with headings.
- Cover: show the plugin inside a chat; write real alt text.
- Highlights: concrete numbers (
Rates from 20+ couriers). - FAQ: the questions you get by email, with direct first-sentence answers (they become rich results in search).
- Both languages: Indonesian and English pages reach more workspaces.
Get listed
A plugin shows in the store when all three are true (the portal tracks them under Get listed in the store):
- A build is approved by Beamvia's review.
- A build is released.
- The store page is approved.
FAQ
How long does a store page review take?
Beamvia reviews builds, store pages, prices and transfers in one queue; the portal shows each under Review queue.
Can I change my store page after it's listed?
Yes. The live page stays until Beamvia approves the change.
Why doesn't my plugin show in the store?
One of the three steps is missing: an approved build, a released build, or an approved store page.