🌐Publish & share

One hub for the live URL, custom domain, collaborators, and what users get after you publish. Get started is a short checklist. /workspace-and-account/share-app/publish and /share-app point here.

What this is / when to use it

Publish writes a version of the app definition that end users can load. Share is how they reach it (NotionApps subdomain, custom domain, or a collaborator invite to the builder).

When not to: you only changed Notion rows — users see those after sync/refresh, without a publish. You only changed builder layout — that needs publish.

Before you start

• Screens you intend to share are in nav or have a deep link.

• Private apps have a test user.

• Custom domain: you can edit DNS.

Build it

Publish the app

1. Click Publish in the builder.

2. Wait for success. If you get 409 Conflict, another tab saved first. See Save conflict.

3. Copy the app link (https://your-app.notionapps.com or your custom domain).

4. Open it in a private window.

Share the link

1. Send the URL. Users do not reinstall after later publishes.

2. For PWA, point them at Add To Home Screen.

Custom domain

1. Open this hub / Custom Domain.

2. Add the hostname. Point DNS as instructed.

3. Wait for HTTPS. Fix “too many redirects” with the troubleshooting page.

4. Extra hostnames: Buy Additional Custom Domains.

Collaborators (edit the app)

1. Invite from Users → Collaborators or this hub’s collaborator entry.

2. Collaborators edit the builder. They are not end users unless you also add them to the Users database.

White-label

Remove NotionApps label is Appearance. It is not a second publish step, but do it before you send a customer the domain.

Every control

Control	What it does
Publish	Writes a live version.
App URL / slug	Subdomain. Reserved slugs are blocked (www, admin, login, …).
Custom domain	Your hostname.
Collaborators	Builder access.
Share App Link	Copy URL.
Version History	Revert.

What users see

The published screens. After a new publish they get the new layout on refresh. They do not reinstall the PWA. Service worker may take one refresh on iOS/Android; see Add to Home Screen.

Limits and plans

• Custom domains and extra domains are plan-gated.

• Each live app counts toward the apps meter.

• Publish does not increase Notion page counts.

Example

First launch: publish on the NotionApps subdomain, test as two roles, then attach app.example.com, then remove the NotionApps label, then send the custom domain to clients.

Fix problems

Symptom	Likely cause	What to do
Users see old layout	Not published, or PWA cache	Publish. Hard refresh.
409 on publish	Multi-tab	409.
Redirect loop	DNS / HTTPS	Custom domain troubleshooting.
Get started 404	Old /basics/share-app/publish	This hub.

Related

First-app checklist. Version History. Add To Home Screen.