2b:null 2c:["$","title",null,{"children":"Pause live edits in public notebooks | Observable | Observable"}] 31:T7a6,## Paused notebooks are still public While the groups above will see a notebook as described, each will be able to see any version of the notebook since the notebook is still public. Changing the notebook to private will remove the paused version. You can still access other versions of the notebook in the following ways. - Navigate versions through the history pane:

- Click the **Paused/Latest** element in the notebook header and choosing to view the paused/latest version of the notebook by clicking the link presented in the popover:

- Add the version aliases `@latest` or `@paused` to the notebook URL: - `https://observablehq.com/@observablehq/pause-live-edits-in-public-notebooks@latest` - `https://observablehq.com/@observablehq/pause-live-edits-in-public-notebooks@paused` If these version aliases are used with a notebook that hasn't been paused, the latest version of the notebook will be shown.32:[{"id":"2cc390830396f9ed55ac3ad1033d722c8bb10ed5cbcad72351da27095e7433d394d50c09e30efa2ae201cd3ffb96531b2431e14e8d84b00d5f0fd8f6531025ed","href":"https://static.observableusercontent.com/files/2cc390830396f9ed55ac3ad1033d722c8bb10ed5cbcad72351da27095e7433d394d50c09e30efa2ae201cd3ffb96531b2431e14e8d84b00d5f0fd8f6531025ed","name":"menu-resume.png","type":"image/png","lastModified":1671045072314.22,"size":21045},{"id":"eaa0556a04c88450ed2573ed837653ec81d664b055599482d81b89c96757bb310565e1bde204f7542e063d5ce9d0ac5e81ee7fef57960dde3f16e1d11dfdd200","href":"https://static.observableusercontent.com/files/eaa0556a04c88450ed2573ed837653ec81d664b055599482d81b89c96757bb310565e1bde204f7542e063d5ce9d0ac5e81ee7fef57960dde3f16e1d11dfdd200","name":"menu-pause.png","type":"image/png","lastModified":1671044899086.696,"size":20703},{"id":"4d2ee968f67020e91ecb40300bd90e9f423d7c322632fcdc20635728cf57929f62a9bf9eff88b8c352873e8e48a5939e54d7ca8f9f5efeae0a3b4602825206ad","href":"https://static.observableusercontent.com/files/4d2ee968f67020e91ecb40300bd90e9f423d7c322632fcdc20635728cf57929f62a9bf9eff88b8c352873e8e48a5939e54d7ca8f9f5efeae0a3b4602825206ad","name":"popout-paused@3.png","type":"image/png","lastModified":1671047834467.908,"size":109748},{"id":"2bf7c14a7b5279ec7186369278342754e017f8cd4580fb0ca7f94c661122fd124fbfd3154c55288d633208c0f58e930c1ead704cf10a085cbb7947006ff3f8bc","href":"https://static.observableusercontent.com/files/2bf7c14a7b5279ec7186369278342754e017f8cd4580fb0ca7f94c661122fd124fbfd3154c55288d633208c0f58e930c1ead704cf10a085cbb7947006ff3f8bc","name":"history@1.png","type":"image/png","lastModified":1671047674470,"size":41001},{"id":"58994beddb4e97c0c8154a33cc7c34c77a920d57d77b25cff829adfb43f9a775f5537a6ca3f82a130ba59d119a69645dffaec4cdc665e76357df37d8d3cf2a90","href":"https://static.observableusercontent.com/files/58994beddb4e97c0c8154a33cc7c34c77a920d57d77b25cff829adfb43f9a775f5537a6ca3f82a130ba59d119a69645dffaec4cdc665e76357df37d8d3cf2a90","name":"republish-action.png","type":"image/png","lastModified":1671047067110.609,"size":4489},{"id":"e135be50219535e8308fe7ace69edf9da4b23327dfb75e9de0517412c0b8cb204a8c0d8e0fd6eeac9eff70507a6953c0b92897993fd5d7634206ab96a6c9ff64","href":"https://static.observableusercontent.com/files/e135be50219535e8308fe7ace69edf9da4b23327dfb75e9de0517412c0b8cb204a8c0d8e0fd6eeac9eff70507a6953c0b92897993fd5d7634206ab96a6c9ff64","name":"popout-latest@3.png","type":"image/png","lastModified":1671046787156.925,"size":136123},{"id":"83e77126a1d0c30db6a0c7874b08649c0add3547eb5d8632cebd843b95dcabda0d4b5d8562e3295d1b3c2e2de2fa5a3631944ecd99d8f729d87a5c21c86d8abf","href":"https://static.observableusercontent.com/files/83e77126a1d0c30db6a0c7874b08649c0add3547eb5d8632cebd843b95dcabda0d4b5d8562e3295d1b3c2e2de2fa5a3631944ecd99d8f729d87a5c21c86d8abf","name":"pause-live-edits.m4v","type":"video/mp4","lastModified":1671049515562.329,"size":334274},{"id":"f635c6dd43ead253d2b77669e2afd0eb3d51204e2c3f6b4974eafe8ff70ac62355435a4e666dbca81b4c14854fa2f6582f14b1dac891b3b330e6fa8d895f78ce","href":"https://static.observableusercontent.com/files/f635c6dd43ead253d2b77669e2afd0eb3d51204e2c3f6b4974eafe8ff70ac62355435a4e666dbca81b4c14854fa2f6582f14b1dac891b3b330e6fa8d895f78ce","name":"pauseMenu_v4.png","type":"image/png","lastModified":1671056418876.458,"size":43647},{"id":"cde55b2022e09efbbb52b5d40ea609429e7c8d88574cc4fb3e3c412be9033a192d4248dbfc9cfc687cb83d65cd4f8a32062452156a9e18cc4d727fdd50b0d09d","href":"https://static.observableusercontent.com/files/cde55b2022e09efbbb52b5d40ea609429e7c8d88574cc4fb3e3c412be9033a192d4248dbfc9cfc687cb83d65cd4f8a32062452156a9e18cc4d727fdd50b0d09d","name":"resumeMenu_v3.png","type":"image/png","lastModified":1671056418876.458,"size":44256}] 2f:{"id":"9eae8a3d798818aa","slug":"pause-live-edits-in-public-notebooks","title":"Pause live edits in public notebooks","thumbnail":"b7bb27bd642bbb4d9bf0efaefe75eabcdbb81278274352d3b33352e4b63176de","access_level":"unlisted","create_time":"$D2022-11-22T23:40:57.498Z","update_time":"$D2022-12-14T22:20:18.876Z","view_time":null,"first_public_time":null,"fork":false,"stars":5,"starred":false,"owner":{"type":"team","id":"f35c755083683fe5","login":"observablehq","name":"Observable","avatar_url":"https://avatars-next.observableusercontent.com/424c6c1f7794371c9915a160519bdfb34cf34e50069fcd6def38a1a04d4e9702","tier":"enterprise_2024"},"version":571,"publish_version":null,"role":null,"authored":false,"authors":[{"type":"individual","id":"796aebc984a74ed9","login":"camdecoster","name":"Cameron DeCoster","avatar_url":"https://avatars-next.observableusercontent.com/63bf40965b2306268a0a220d959c35f633e206124542ac31f17d36ccf0d106a8","tier":null},{"type":"individual","id":"b2ae65df1901fe65","login":"mythmon","name":"Michael Cooper","avatar_url":"https://avatars-next.observableusercontent.com/60cdc428c59f56064db989dbde23b5af37103628a470beeebd56d0c18c206120","tier":null}],"members":[{"type":"group","id":"c4990be612f2da51","login":"8788045797a2fd14","name":"Product Education","avatar_url":null,"tier":"public","role":"editor"},{"type":"team","id":"f35c755083683fe5","login":"observablehq","name":"Observable","avatar_url":"https://avatars-next.observableusercontent.com/424c6c1f7794371c9915a160519bdfb34cf34e50069fcd6def38a1a04d4e9702","tier":"enterprise_2024","role":"editor"}],"comments":[],"custom_thumbnail":true,"trashed":false,"subscribed":null,"forks":1,"collection":{"id":"f32cb7b0d22ffb6a","slug":"editing-publishing-collaborating","title":"Sharing and Collaboration","owner":{"id":"f35c755083683fe5","login":"observablehq","name":"Observable"}},"type":"notebook","body":{"title":"Pause live edits in public notebooks","cells":[{"id":0,"value":"# Pause live edits in public notebooks\n\n${document.baseURI.toString().includes(\"@latest\") ? \"Nice job using the new feature. Welcome to the future!\" : \"\"}","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined"},{"id":445,"value":"

\n FileAttachment(\"pause-live-edits.m4v\").url())}\n \n

\n","pinned":false,"hidden":false,"mode":"html","author":"$undefined","summary":"$undefined"},{"id":571,"value":"You can pause a **public notebook** at the current notebook version, which allows you to edit your notebook without the public seeing your edits in real-time.\n\nNormally, public notebooks default to live editing (this is explained more fully in [Team and Individual Workspaces](https://observablehq.com/@observablehq/team-and-individual-workspaces#freeIndividual)), which means that changes are visible to viewers immediately. But if you *pause live editing*, you can make changes without showing the changes to the public until you are ready.","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined"},{"id":35,"value":"- To pause a notebook, click the menu button and select **Pause live editing**.\n- To resume a notebook, click the menu button and select **Resume live editing**.\n\n

\n","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined"},{"id":38,"value":"## What will users see?\nOnce paused, the notebook will be presented (by default) in two ways for two groups:\n- **Members** will see the **latest** version of the notebook, including any live edits. \n A member is someone who has an association with the notebook: the individual owner (often the creator), someone you’ve shared your notebook with, a member of the team that owns the notebook, etc. \n- **Non-members** will see the **paused** version of the notebook. \n A non-member is the general public. Non-members may include both signed‑in and signed‑out (anonymous) users.","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined"},{"id":40,"value":"$31","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined"},{"id":66,"value":"## How are edits handled in a paused notebook?\nOnce a notebook is paused, any further edits to the notebook will continue to be saved. If edits have been made subsequent to the paused version, an editor will be presented with a **Republish** button as a promoted action. Clicking this button will bring the paused version up to the current notebook version, while continuing to keep the notebook paused.\n\n

The promoted actions in the notebook header

\n\nIf a non-member (or a member looking at the paused version) tries to edit the notebook, the user will be placed into [Tinker mode](https://observablehq.com/@observablehq/tinker-mode).\n","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined"},{"id":362,"value":"## How is search handled?\n\nUsers can find the same versions of a notebook that they would see by visiting the notebook. A notebook member will find the latest version of a notebook in search. Non-members will see the paused version in search. Although both versions are publicly visible by visiting the notebook, only the default version (latest or paused) will be visible in search.","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined"},{"id":449,"value":"## How will imports be handled?\n\nPause live edits follows our current model for access privileges. As such, the following statements describe what version of a paused notebook a user will import by default (without using `@latest` or `@paused` in the import statement):\n\n- If anyone imports from a paused notebook into a public notebook, they will receive the paused version.\n- If a member imports from a paused notebook into a private notebook, they will receive the latest version.\n- If a member imports from a paused notebook into a private notebook and shares the private notebook with any other user, the member and the user will receive the paused version. _This only applies to individual notebooks because team notebooks can't be shared outside of the team._","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined"},{"id":329,"value":"## Workflow with pause live edits\n\nLet's use a branch diagram to walk through what happens when you use the pause live edits feature on a public notebook. There's really only one notebook and you see it at different points (depending on whether you're a member or non-member), but a branch diagram is a helpful way to show what the different groups see.\n","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined"},{"id":331,"value":"In versions 1 and 2, you've added some content to a notebook and it looks ready for everyone to view so you send it to some colleagues. At this point, everyone sees the same version of the notebook.\n\n

","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined"},{"id":333,"value":"After some thought, you decide that you'd like to add a bit more content. You're worried that you might break some cells in the process, so you **pause live editing** at v2. At this point we split the public into members and non-members, but both groups still see the same version of the notebook.\n\n

\n","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined"},{"id":335,"value":"In versions 3 through 5 you add more content. You take a minute to consider your changes. At this point, non-members are seeing the notebook at version 2 and members are seeing the notebook at version 5.\n\n

\n${mermaid`%%{init: {'theme': 'base', 'gitGraph': {'mainBranchName': 'member-view'}, 'themeVariables': {'commitLabelFontSize': '12px'}}}%%\ngitGraph\n commit id: \"v1 add intro\"\n commit id: \"v2 add charts\"\n branch non-member-view\n commit id: \"paused at v2\"\n checkout member-view\n commit id: \"v3 add more charts\"\n commit id: \"v4 add interactivity\"\n commit id: \"v5 fix spelling\"\n`}\n

","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined"},{"id":337,"value":"You're satisfied with your changes so you **Republish** your changes, which updates the paused version to v5. At this point, members and non-members will see the same version of the notebook again.\n\n

\n${mermaid`%%{init: {'theme': 'base', 'gitGraph': {'mainBranchName': 'member-view'}, 'themeVariables': {'commitLabelFontSize': '12px'}}}%%\ngitGraph\n commit id: \"v1 add intro\"\n commit id: \"v2 add charts\"\n commit id: \"v3 add more charts\"\n commit id: \"v4 add interactivity\"\n commit id: \"v5 fix spelling\"\n branch non-member-view\n commit id: \"paused at v5\"\n`}\n

\n","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined"},{"id":107,"value":"You let your colleagues know that you've updated the notebook and they provide some minor feedback. You make a final update in version 6 based on that feedback.\n\n

\n${mermaid`%%{init: {'theme': 'base', 'gitGraph': {'mainBranchName': 'member-view'}, 'themeVariables': {'commitLabelFontSize': '12px'}}}%%\ngitGraph\n commit id: \"v1 add intro\"\n commit id: \"v2 add charts\"\n commit id: \"v3 add more charts\"\n commit id: \"v4 add interactivity\"\n commit id: \"v5 fix spelling\"\n branch non-member-view\n commit id: \"paused at v5\"\n checkout member-view\n commit id: \"v6 make it perfect\"\n`}\n

\n","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined"},{"id":339,"value":"Now that the notebook is perfect, you **Resume live editing**. The notebook is back to a public view, with no members or non-members.\n\n

\n${mermaid`%%{init: {'theme': 'forest', 'gitGraph': {'diagramPadding': 55, 'mainBranchName': 'public-view'}, 'themeVariables': {'commitLabelFontSize': '12px'}}}%%\ngitGraph\n commit id: \"v1 add intro\"\n commit id: \"v2 add charts\"\n commit id: \"v3 add more charts\"\n commit id: \"v4 add interactivity\"\n commit id: \"v5 fix spelling\"\n commit id: \"v6 make it perfect\"\n`}\n

","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined"}],"files":"$W32","stdlib":"1","titling":"auto"}} 30:"$2f:body"