> For the complete documentation index, see [llms.txt](https://docs.notionapps.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.notionapps.com/publish-and-share.md).

# Publish & share

One hub for the live URL, custom domain, collaborators, and what users get after you publish. Get started is a [short checklist](https://docs.notionapps.com/get-started/publish-and-share). `/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](https://docs.notionapps.com/databases/reload-and-sync), 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](https://docs.notionapps.com/troubleshooting/save-conflict-409-multi-tab).
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](https://docs.notionapps.com/workspace-and-account/add-to-home-screen-pwa).

### Custom domain

1. Open this hub / [Custom Domain](https://docs.notionapps.com/screens-and-components/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](https://docs.notionapps.com/screens-and-components/custom-domain/buy-additional-custom-domains).

### Collaborators (edit the app)

1. Invite from Users → [Collaborators](https://docs.notionapps.com/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](https://docs.notionapps.com/settings/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](https://docs.notionapps.com/settings/version-history). |

## 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](https://docs.notionapps.com/troubleshooting/save-conflict-409-multi-tab). |
| Redirect loop        | DNS / HTTPS                     | Custom domain troubleshooting.                                                  |
| Get started 404      | Old `/basics/share-app/publish` | This hub.                                                                       |

## Related

[First-app checklist](https://docs.notionapps.com/get-started/publish-and-share). [Version History](https://docs.notionapps.com/settings/version-history). [Add To Home Screen](https://docs.notionapps.com/workspace-and-account/add-to-home-screen-pwa).