Skip to main content
An extension has at most two releases: the live one every install is serving, and one other — waiting on review, withdrawn back to a draft, or rejected. Publishing overwrites rather than accumulating, so there is no version to pick and nothing to promote. The version a release is labelled with is your package.json version, read out of the bundle.

​
What a publish becomes

“A new contribution kind” means a kind the live release does not have — your first widget, your first action, your first storage collection. A second widget is not a new kind. The seven assistant blocks count separately, so your first skill is a new kind even when you already ship tools. Dropping a scope or a contribution kind never sends a release to review.

​
Release notes

At most 1,000 characters. Owners read them on the install’s page in their dashboard; a reviewer reads them first. They are stored on the release and on the timeline, so “what changed in 0.4.0” has an answer after the fact.

​
Withdrawing a pending release

A release in review can be pulled back to a draft from the Releases page in the developer portal. The live release is untouched and the review timeline is kept. Publish again when you are ready and it re-enters review. Publishing while a release is still in review replaces that release rather than queueing a second one.

​
What owners see

An approved release swaps into live and every install picks it up on its next load; the host re-reads its installs about once a minute while the dashboard is open. When the new release asks for a scope an owner has not granted, their install renders
with Review scopes and Keep current, and the rest of their dashboard is unaffected. Owner admins are told once, when a release that widened the scope set goes live — after a reviewer approves it, or when the automated checks approve an unlisted one. A private publish sends no notice, so the card is the only signal there. A rejected release is marked rejected on the Releases page with the reviewer’s reason. Nothing changes for owners.