Help Center

Synced pages across your styleguide

Brienne Wong

You can sync pages across your styleguides. This is beneficial if you want to align content across styleguides and provide a single source of truth. If you split your documentation for different platforms and products, you can display a core design system documentation in each styleguide.

Enable page syncing

1) Click on the ... next to the page name

2) Toggle Page syncing on

3) The page will be added to the synced page library. This means it is available to be added to other styleguides in your team.

Synced Pages and workspaces

When using Synced Pages within workspaces, you are able to control whether synced pages within a styleguide can be added to styleguides:

• within the same workspace only (the default), or
• across all workspaces

To change the visibility of the synced page, click the button in the banner to be taken go to the Styleguide settings for Synced pages.

By enabling this setting – all synced pages from this styleguide will be available to Editors across all workspaces.

Add a synced page

1) In the sidebar, click on the ... next to Add page

2) Choose Add synced pages

3) Select one or more pages from the synced page library – the styleguides are listed on the left

4) The page(s) will be synced to the styleguide you are editing

5) Going forward, these pages will stay in sync with the original page

Make edits and comments

You can only make edits or add comments to the original page, in the original styleguide. If you have editor or reviewer access to the original styleguide, you’ll seen an option to go to the original page by clicking the Go to original button

FAQs

Who can add synced pages to a styleguide?

Any editors, even if they don’t have editor access to the original styleguide.

Why can’t I see a page in the synced pages library?

It’s likely this is due to either:

• the security settings of the styleguides
• the original page not existing in the default release of the original styleguide, or
• the original page being in a styleguide in workspace that the editor is not a member of

How does this work with hidden pages?

If a page is hidden in the original styleguide, you can’t “unhide” it in the second styleguide. To have a page be visible, the page must be marked visible in the original styleguide.

What happens if I delete or unsync the original page?

If the original page is deleted or syncing is turned off, the synced page will still display for editors, but the content will be blank. The page will not display for viewers of the styleguide.

How does security work?

You can sync pages between styleguides if:

• they both use SSO
• the styleguide with the original page is public

At this time, you can’t:

• sync between password-protected styleguides
• sync private pages (SSO or password-protected)

How do releases work with synced pages?

Releases are managed in the original styleguide that the page was created in.

The synced page will always display the default release of the original page. The content is always the same between the two styleguides and viewers would see the exact same content on the pages that are synced.

If the page doesn’t exist in the default release of the styleguide it was created in, you won’t be able to add it as a synced page. Create a new release in the original styleguide to add it as a synced page.

How does page versioning work with synced pages?

The page versions are managed in the original styleguide that the page was created in. If you restore a page to a past version, and it’s synced in another styleguide, the past version will be displayed.