Publish a blog article

How to take a blog post from your project and put it on the web, as a page you can share and as an entry on your portal.

Check the destination

Every project has its own public address, its handle, from the moment you create it. In the blog post's toolbar, next to the publish control, the handle appears as a round @handle avatar. This is the article's destination: the place it publishes to.

• Lit: the article publishes to your address and your portal.
• Dimmed: the article has nowhere to go, and publishing is switched off. Click the avatar to light it.

A blog post you add from the canvas Create menu starts with its destination lit. A post made with the Blog page starter starts with it dimmed, so light it before you publish. On a phone, the avatar is in the article's tools sheet, under Accounts.

Publish from the blog post

Open the blog post in the editor. Its toolbar holds one publish control, an icon whose tooltip reads Choose which versions of this article are public. Click it to open its menu, whose title says what readers can see: Private until something is published, then Visible to everyone. To choose what is public:

1. Under Versions, tick each version of the article you want to publish. The version's card then reads Will be published.
2. Press Publish at the foot of the menu.

If the destination is dimmed, the button stays disabled and the menu says Light a destination to publish this article to. Closing the menu without pressing the button changes nothing. Publishing is owner-only: you must be signed in.

From then on the public page shows whatever you last published. Your working draft stays private: after an edit, the control carries an Edited since publishing marker and the version's card reads Visible, with unpublished edits. Press Publish again to update the public page.

Where the article lives

Each published version's card in the menu links to its public address, for example:

https://<your-handle>.papera.dev/blog/<your-slug>

You can change the handle in the project's Settings → Address with Change handle. Changing it breaks the old address at once, so update any links you've shared. If you connect your own domain, your articles are served from there instead.

To list every published article on one page that readers can search and filter, turn on Portal in the project's settings. It is off for a new project. Turning it off hides only that list: every article keeps its own address.

Choose the URL (slug)

The slug is the last part of the URL. It is suggested from your title, and you can edit it in the article's Properties → SEO → Slug. All versions of the article share one slug.

A new slug takes effect the next time you press Publish. Until then, the public page stays at the old address, and every published version is marked as having unpublished edits. When you publish, the article moves to the new address and the old address answers not found. There is no redirect, so update any links you've shared.

A slug is unique among the published articles of a project, in every language. If the one you picked is already taken, publishing stops before anything changes and tells you, with a free alternative (for example my-article-2). Press Use suggested slug to take it, then publish again.

Take it down

There are two ways to take an article down. Both make its public page answer not found, as if the article had never been published, and both remove it from your portal and sitemap. Your draft is kept, so you can keep editing and publish again later.

• One version at a time: open the publish control, untick the versions you want to take down (their cards read Will be taken down), and press Take down. The destination stays lit, so to bring a version back, tick it and press Publish.
• The whole article at once: click the lit @handle avatar to dim it. Every version goes offline together. To bring the article back, light the avatar again, then tick the versions and press Publish. Lighting the avatar on its own does not republish anything.

Deleting a published blog post's node asks what to do with the article: Keep it published leaves it online with no node to take it down from later, and Delete the article too takes it down first.