Skip to content

The open alternative to Salesforce, designed for AI.

docs: Introduce third-party marketplace vetting criteria (#28457)

martmull18da1eb626db
diff --git a/packages/twenty-docs/developers/extend/apps/operations/marketplace-vetting.mdx b/packages/twenty-docs/developers/extend/apps/operations/marketplace-vetting.mdx
new file mode 100644
index 00000000000..623c0a4f2f6
--- /dev/null
+++ b/packages/twenty-docs/developers/extend/apps/operations/marketplace-vetting.mdx
@@ -0,0 +1,57 @@
+---
+title: Marketplace vetting (WIP)
+description: Proposed requirements for third-party apps to receive a Vetted badge.
+icon: 'shield-halved'
+---
+
+<Warning>
+ **Work in progress.** This page and its requirements may evolve. Third-party
+ vetting is not available yet. See
+ [Publishing](/developers/extend/apps/operations/publishing#marketplace-visibility-and-vetting)
+ for current marketplace behavior.
+</Warning>
+
+Vetting applies to an exact app version and package. Each update needs review and
+approval from Twenty. Vetted apps may be reassessed as dependencies or services
+evolve.
+
+## Vetting checklist
+
+All applicable items must pass. We recommend using an agent to self-evaluate
+each criterion with evidence and required fixes before submitting.
+
+- [ ] **Publisher.** [Claim your app](/developers/extend/apps/operations/publishing#claiming-your-app)
+ and [publish with provenance](/developers/extend/apps/operations/publishing#ci-publishing).
+- [ ] **Security.** Pass Twenty's internal security review and resolve blocking
+ findings.
+- [ ] **Permissions.** Request only the
+ [permissions](/developers/extend/apps/config/roles) needed for the app's features.
+- [ ] **Functionality.** Setup and core workflows are easy to follow and work as
+ advertised, without crashes, lost work, or duplicate records. No placeholder
+ features or broken controls.
+- [ ] **Performance.** Respect shared API/job rate limits, handle throttling, and
+ follow the
+ [app development good practices](/developers/extend/apps/getting-started/good-practices).
+- [ ] **Usefulness.** Complete a meaningful CRM task for a broader audience than
+ one customer's setup. Small connectors and headless automations qualify.
+- [ ] **Native experience.** Reuse native objects, views, and workflows where appropriate.
+ If the app has a UI, use
+ [`twenty-ui`](/developers/extend/apps/layout/front-components#using-twenty-ui-components)
+ and match Twenty's layouts, interactions, and accessibility conventions.
+- [ ] **Privacy.** Explain what data leaves the workspace, where it goes and why,
+ including AI providers, how long it is kept, and how it can be deleted.
+- [ ] **Maintenance and compatibility.** Declare supported Twenty versions, keep
+ entity identifiers stable, and fix critical bugs and broken integrations over
+ time.
+- [ ] **Logo and gallery.** Provide an original, recognizable logo and polished
+ images of the actual app. Follow the
+ [image guidelines](/developers/extend/apps/operations/publishing#marketplace-metadata).
+- [ ] **Listing and README.** Accurately describe features and affiliations in
+ the name, description, and screenshots. Keep the README short, well-formatted,
+ and focused on the app's value.
+- [ ] **Pricing.** Clearly state whether the app is free or paid, plan prices,
+ billing frequency, and any required paid third-party services.
+- [ ] **Documentation and support.** Provide setup instructions, a working example,
+ and a support contact. If using shared routes, complete
+ [setup](/developers/extend/apps/operations/publishing#setting-up-server-routes)
+ and verify events reach the correct workspace.
diff --git a/packages/twenty-docs/developers/extend/apps/operations/overview.mdx b/packages/twenty-docs/developers/extend/apps/operations/overview.mdx
index 7d7d9340e80..98c2058220c 100644
--- a/packages/twenty-docs/developers/extend/apps/operations/overview.mdx
+++ b/packages/twenty-docs/developers/extend/apps/operations/overview.mdx
@@ -53,6 +53,9 @@ The **operations layer** is everything you do _to_ your app rather than _with_ i
>
Build, deploy a tarball, publish to npm, install.
</Card>
+ <Card title="Marketplace vetting (WIP)" icon="shield-halved" href="/developers/extend/apps/operations/marketplace-vetting">
+ Proposed security, quality, and operational checks for third-party app versions.
+ </Card>
<Card title="Monitoring" icon="chart-line" href="/developers/extend/apps/operations/monitoring">
Errors, rate limits, credits and function performance across installs.
</Card>
diff --git a/packages/twenty-docs/developers/extend/apps/operations/publishing.mdx b/packages/twenty-docs/developers/extend/apps/operations/publishing.mdx
index a725400bea3..2d47636dce3 100644
--- a/packages/twenty-docs/developers/extend/apps/operations/publishing.mdx
+++ b/packages/twenty-docs/developers/extend/apps/operations/publishing.mdx
@@ -378,6 +378,10 @@ Claiming establishes ownership; it does not grant a **Vetted** badge. The market
The Vetted label currently applies to apps maintained by Twenty, for which the team can vouch for security and quality. Third-party apps can be published and installed without this label.
+The proposed [third-party marketplace vetting checklist](/developers/extend/apps/operations/marketplace-vetting)
+is a work in progress. It describes version-specific review criteria and evidence,
+not an available certification program.
+
If your app is still missing with **Vetted only** turned off, confirm catalog sync has completed, all required server variables are filled in, and any server-route setup is complete.
## Installing apps
diff --git a/packages/twenty-docs/docs.json b/packages/twenty-docs/docs.json
index 0aa518eadef..5b857a3ff66 100644
--- a/packages/twenty-docs/docs.json
+++ b/packages/twenty-docs/docs.json
@@ -487,6 +487,7 @@
"developers/extend/apps/operations/testing",
"developers/extend/apps/operations/translations",
"developers/extend/apps/operations/publishing",
+ "developers/extend/apps/operations/marketplace-vetting",
"developers/extend/apps/operations/monitoring"
]
}
diff --git a/packages/twenty-docs/navigation/base-structure.json b/packages/twenty-docs/navigation/base-structure.json
index 9789de85c46..0128257db51 100644
--- a/packages/twenty-docs/navigation/base-structure.json
+++ b/packages/twenty-docs/navigation/base-structure.json
@@ -492,6 +492,7 @@
"developers/extend/apps/operations/testing",
"developers/extend/apps/operations/translations",
"developers/extend/apps/operations/publishing",
+ "developers/extend/apps/operations/marketplace-vetting",
"developers/extend/apps/operations/monitoring"
]
}
diff --git a/packages/twenty-shared/src/constants/DocumentationPaths.ts b/packages/twenty-shared/src/constants/DocumentationPaths.ts
index 1d69fdfe062..1bf48712ffe 100644
--- a/packages/twenty-shared/src/constants/DocumentationPaths.ts
+++ b/packages/twenty-shared/src/constants/DocumentationPaths.ts
@@ -80,6 +80,8 @@ export const DOCUMENTATION_PATHS = {
'/developers/extend/apps/logic/workflows',
DEVELOPERS_EXTEND_APPS_OPERATIONS_CLI:
'/developers/extend/apps/operations/cli',
+ DEVELOPERS_EXTEND_APPS_OPERATIONS_MARKETPLACE_VETTING:
+ '/developers/extend/apps/operations/marketplace-vetting',
DEVELOPERS_EXTEND_APPS_OPERATIONS_MONITORING:
'/developers/extend/apps/operations/monitoring',
DEVELOPERS_EXTEND_APPS_OPERATIONS_OVERVIEW: