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
Section titled “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
Section titled “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
Section titled “Build it”Publish the app
Section titled “Publish the app”- Click Publish in the builder.
- Wait for success. If you get 409 Conflict, another tab saved first. See Save conflict.
- Copy the app link (
https://your-app.notionapps.comor your custom domain). - Open it in a private window.
Share the link
Section titled “Share the link”- Send the URL. Users do not reinstall after later publishes.
- For PWA, point them at Add To Home Screen.
Custom domain
Section titled “Custom domain”- Open this hub / Custom Domain.
- Add the hostname. Point DNS as instructed.
- Wait for HTTPS. Fix “too many redirects” with the troubleshooting page.
- Extra hostnames: Buy Additional Custom Domains.
Collaborators (edit the app)
Section titled “Collaborators (edit the app)”- Invite from Users → Collaborators or this hub’s collaborator entry.
- Collaborators edit the builder. They are not end users unless you also add them to the Users database.
White-label
Section titled “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
Section titled “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
Section titled “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
Section titled “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
Section titled “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
Section titled “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. |