Shared vocabulary for builders, Store ops, and Platform APIs. Keep these terms stable as products GA.
App vs plugin
| Term |
Definition |
Typical shape |
| App |
Installable product experience on Tradeics |
Store listing + runtime + optional UI |
| Plugin |
Focused extension that hooks a product surface |
Manifest capabilities + handlers |
| Listing |
Store-facing metadata (name, pricing, screenshots) |
Bound to one or more app versions |
| Installation |
Org-level grant to run an app |
Scopes + billing state |
Plugins are often shipped as apps (one listing, narrower capabilities). Use plugin in docs when emphasizing a product hook; use app for Store and billing.
Visibility
| Mode |
Who can find / install |
| Public |
Discoverable in the App Store (subject to review) |
| Private |
Only invited orgs / same publisher org (and partners) |
| Unlisted |
Install via direct link; not search-indexed (when enabled) |
Commercial models
| Model |
Notes |
| Free |
No charge; still subject to review and rate limits |
| One-time |
Single purchase per org (or seat pack) |
| Subscription |
Recurring org or seat billing |
| Usage-metered |
Bill against metered events (API calls, jobs) |
| Freemium |
Free tier + paid plan upgrade |
Trust & tenancy
- Installations are per workspace (never silently global).
- Data access follows declared scopes and org admin approval.
- Publishers never receive customer API keys — they receive app install tokens with limited scopes.
Next