Skip to main content
--publish=web builds and signs a Rive project, and hosts it as a public page anyone can open: one URL playing the built .riv. --publish on its own writes a signed .riv to disk.

Publish a page

1

Login

Publishing needs a signed-in session, for the reason covered under signing and the web runtime.
2

Choose a Workspace

Pages belong to a Workspace. If you aren’t a member of any Workspace, the CLI creates a Free Workspace for you when you sign in, or when you next publish. To create another Workspace, run rive workspace create <name>. You can also create a Workspace in the Rive Editor, or join an existing one.If you’re an Editor in one Workspace, the CLI picks it for you. If you’re an Editor in several, the CLI opens a picker to select one. To skip the question, pass the Workspace ID with --workspace=<id>. rive workspace lists your Workspaces and their IDs. --team=<id>, the older name for this flag, still works.
3

Publish

The CLI builds the project, signs it, uploads it, waits for the page to go live, and prints the public URL. The name comes from --name=<name> if you pass one, then pages.name once the project has published before, then the project’s name in rive.yaml. So renaming the project does not move an existing page.
The first publish records where the page lives by writing a pages: block into rive.yaml. Later publishes leave it alone:

Signing and the web runtime

A published page is played by the Rive web runtime, and web runtimes refuse unsigned scripts. An unsigned build would load and then play nothing, so --publish=web always builds the way --publish does. The same watermark rule as --publish applies. A web publish from a project that isn’t bound to a file counts against the Workspace that owns the page, and that Workspace’s plan decides the watermark. See Which Workspace counts.

Republish a page

A page is identified by its name within its Workspace. The name is lowercased into a slug (anything outside a-z0-9 becomes a dash), and the url is that slug plus a short random suffix minted once, when the page is created. Publishing the same name again replaces what the url serves. The url does not change, so a link you handed out keeps working and starts showing the new build. Publishing a different name creates a different page at a different url. --name=<name> on a later publish is a one-off: it publishes to that name without changing the pages: block, so the project keeps pointing at its original page.

Publish from CI

--no-wait prints the url and exits as soon as the upload is accepted, without waiting for the page to go live. With --quiet, stdout is two lines: the name (with its expiry date, if it has one) and then the url.
Set pipefail before piping the output. Without it the pipeline reports tail’s status rather than the CLI’s, so a failed sign-in, build or upload exits 0 and the job carries on with an empty url.
Pass --workspace=<id> as well, since the CLI can’t ask which Workspace to use when stdin is not a terminal.
Publishing is rate limited per account. A run that hits the limit reports too many publishes for now.

Set how the control bar starts

A published page carries a small bar of controls for its fit, full screen, and copying its url. The bar shows for a moment and then hides to a lip at the bottom of the page. --drawer=<mode> changes how it starts: The first time the bar opens, a tooltip over its Rive link reads “Made with Rive. Build your own.” for a few seconds. On a page that starts with only the lip, the tooltip shows above the lip first. On a paid plan, --no-promo leaves the tooltip off. If your Workspace moves to a plan without these options, its pages show the tooltip and the bar again, until you upgrade. Each publish sends its own settings, so pass --drawer= and --no-promo every time you publish the page.

List published pages

List your published pages with the list-published command.
built means the file is on disk. not published means no page was found for the project’s pages: binding.

Unpublish a page

--unpublish=web has no undo. The url stops resolving, the files are removed, and the name frees up. Publishing that name again mints a new url, so the old link does not come back. The CLI asks for confirmation unless --yes is passed; in CI, where there is no terminal to confirm on, set this flag.

Page expiry

On some plans, a page may expire after its first publish. When a page has an expiry date, the publish prints it on its first line, in your own time zone:
Republishing a live page keeps its date. Once a page has expired, its url stays offline and its name frees up, so publishing the name again makes a new page at a new url.

Flags