The Publish screen shows every change to your site as a card on a board.
The board has up to four steps: Your changes, Review, Staged, and Published.
/assets/flows-blog-staged.webm
A change moves from left to right, one step at a time.
You decide what moves. Nothing goes live until you send it forward.
This article explains the controls. For the publish procedure, see Publish your site.
Open the Publish screen
Click Publish in the main navigation. The Publish screen opens.
Note: A number on Publish shows how many changes wait for review.
The four steps
| Step | What it shows | When it shows |
|---|---|---|
| Your changes | Changes on your computer since your last publish | Always |
| Review | Changes that people sent for review | When the site has teammates, or when you sent changes |
| Staged | Changes on the staging site that are not live | When the site has a staging address |
| Published | Each publish, with everything it contained | Always |
Notes:
- The steps show side by side when they all fit. If the space is too narrow, the steps stack in one column.
- The Agent panel takes space. Open it and the steps stack.
- Staged has a link to the staging site. Published has a link to the live site.
The card
Each step shows its changes on a card.
The card has three parts:
- The header. The header shows who made the changes and when.
- The list. The list shows each change in a group: Pages, Content, Design, Components, Files, or Site.
- The footer. Quiet actions are on the left. The way forward is on the right.
A row in the list
| Part | What it does |
|---|---|
| Check box | Select the change for the next step |
| Icon and name | Show what changed, in friendly words. Example: "Home" |
| Conflict chip | Show that the same item changed in more than one place |
| Status pill | Show the kind of change, or where the change is |
| Eye button | Preview a page as a teammate sent it (Review only) |
| … button | Open the row menu: See code changes, Discard |
The status pill shows one of these words:
| Pill | Meaning |
|---|---|
| New | The item is new since the last publish |
| Edited | The item changed |
| Removed | The item was deleted |
| For review | Your item is in review, without more edits |
| Staged | Your item is on the staging site, without more edits |
Note: Edit an item again and the pill goes back to Edited.
The new version is only on your computer.
Decide what goes live
You publish what has a check mark. You keep the rest for later.
- Open the Publish screen.
- Remove the check mark from each change that must wait.
- Read the green button. The button counts what you selected. Example: "Publish 6 changes".
- Click the green button.
| Control | Result |
|---|---|
| Select all | Add a check mark to every row on the card |
| Clear all | Remove a check mark from every row on the card |
| Green button | Do the next step for the selected changes |
| Arrow next to the green button | Show the steps you can skip to |
The green button always offers the next step. The arrow offers the steps after it.
| Your role | Buttons on the card |
|---|---|
| Owner or admin | Send for review, Stage, Publish |
| Editor | Send for review |
| Viewer | None |
Notes:
- Each card keeps its own check marks. A change in Review is not the same row as your change.
- A card that nobody touched has a check mark on every row.
- Staging needs a staging address. See Set up a staging domain.
See the difference
The steps speak about pages and items. The code view speaks about files and lines.
Use the code view when you want to see exactly what changed.
- Click the … button.
- Select See code changes.
Where you click decides what you see:
| Where you click | What the view shows |
|---|---|
| … in the card header | Every file behind the whole card |
| … on a row | The files of that item only |
The view has the files on the left and the differences on the right.
| Part | What it does |
|---|---|
| File list | Select a file. A tag shows New, Deleted, or Unchanged |
| Left column | The last published version |
| Right column | The version in this change, or the version on your computer |
| + and − counts | Show how many lines came and went |
| Grey gap row | Hide unchanged lines. The row says how many |
Notes:
- The view opens the file that differs first.
- Red is the old line. Green is the new line.
- The view is read only. It does not publish, discard, or change anything.
- An image or a font has no lines. The view says that the file was added, deleted, or replaced.
- A very large file does not show its lines.
- A change with many files lists the first 200 files.
A page in the list that you did not open. This is correct behavior.
A site-wide change travels with the page. Example: a style rule that every page reads.
The row menu shows this message: "Nothing changed in this item's own files."
Click See what changed to see the file that caused it.
Preview a page
Click the eye button on a row under Review.
The page opens in a separate window, as the teammate sent it.
Note: The eye button is quiet for a deleted page. A deleted page has nothing to show.
Conflicts
A row shows Conflict when the same item changed in more than one place.
Hold the pointer over the chip. The text says who else changed the item and gives a tip.
Nothing is overwritten by itself. Click Stage or Publish and the app asks you to decide.
- Click Compare to see both versions.
- Click Keep mine or Use theirs.
- Click Stage or Publish again.
Discard
Discard is in the row menu and in the card footer.
The word is the same in each step. The act is different in each step.
| Step | What Discard does |
|---|---|
| Your changes | Puts the item back to your last publish. Your work on it is gone |
| Review | Takes the item out of review. Your copy on this computer does not change |
| Staged | Takes the item off the staging site. Staging goes back to what is live |
Caution: Discard under Your changes cannot be undone.
A warning appears each time. Click Discard again to confirm. Click Cancel to stop.
Note: An unchecked change is safe. Only Discard removes work.
Published
The Published step shows each publish as a card.
| Control | Result |
|---|---|
| Show all | Show every publish, not only the last three |
| Show fewer | Show only the last three publishes |
| Restore this version | Set your changes back to that publish |
Restore does not publish. Your changes go back to that version.
Publish again to make it live.
Note: Only the site owner and admins can restore a version.
Messages on the screen
| Message | Meaning |
|---|---|
| AI changes not reviewed | The Agent panel changed things you did not read. Click Undo all, Keep all, or Review |
| Accessibility suggestions | The app found things to improve. Click the message to read them. They do not block a publish |
| You're offline | Editing works. Sending, staging, and publishing need a connection |
| Reconnect to see what is in review | The app cannot reach the team service. Open the publishing settings |
| A publish license is needed | Sending and publishing need a license. Click Unlock publishing |
| Set up publishing first | The site has no GitHub connection or no host. Click Set up publishing |
The first publish
Your whole site goes live on the first publish. You cannot select parts of it.
Click Publish everything.
After the first publish, you select exactly which changes move on.