Breadcrumbs

Overwrite Page Content Between Versions

Imagine you have completed a significant rewrite on an article, have fixed a lot of broken content, or created a new page in a version you need to transfer to already saved versions. You have saved multiple versions of the article, and updating each version manually can be quite time-consuming. However, with the Scroll Documents Overwrite, this process becomes much simpler and more efficient.

Overwrite Content

The Overwrite enables you to:

  • Replace content: You can replace the content of a page with the content from the same page in any other version.

You can always revert overwritten content by accessing the page history of the overwritten page and restoring it to the revision before the new content was added.

  • Add new pages: You can add a page that you created in one version into another version where it does not yet exist.

How to replace content

To overwrite content from one page version to another, follow these steps:

  1. Click on Compare versions, either via the Document toolbox or in the Document Manager.

  2. In the Compare versions dialog, locate the updated page.

  3. Set the pickers to display the correct versions (as well as variants and languages, if enabled).

  4. Click on one of the arrows (<< >>) to choose which direction you want to overwrite content:

    • Open overwrite right to left dialog

    • Open overwrite left to right dialog

  5. Carefully read through the dialog to understand which page you are about to overwrite and which page you are copying content from.

  6. Finally, click Overwrite to replace the content on the target page.

How to add a page to a new version with overwrite

Follow these steps to copy a page that exists in one version but is missing from the other:

  1. Click on Compare versions, either via the Document toolbox or in the Document Manager.

  2. In the Compare versions dialog, set the pickers to display the correct versions (as well as variants and languages, if enabled).

  3. Locate the page you want to copy over to another version.

    • The page tree within the Compare versions dialog will indicate that the page is missing from one of the versions, and clicking on it will display the message: “This page doesn't exist in the selected version yet.”

  4. Click Add page, a dialog will open.

  5. Carefully review the dialog to understand which page you are about to create and in which version.

  6. Finally, click Overwrite to create the page in the target version.

What Content is Overwritten?

Here is how the overwrite works :

Content

Will this content get overwritten?

What happens when I overwrite this content?

Paragraph content

Yes https://k15t.jira.com/wiki/s/-2050679084/6452/aedacba96270a5dc0427a9eafee540f7492e3a5b/_/images/icons/emoticons/check.png


The text content from the source page will replace all text content on the target page.

Page title

No https://k15t.jira.com/wiki/s/-2050679084/6452/aedacba96270a5dc0427a9eafee540f7492e3a5b/_/images/icons/emoticons/error.png

The page title of the target page will not be overwritten by the page title from the source page.

Scroll Page title

No https://k15t.jira.com/wiki/s/-2050679084/6452/aedacba96270a5dc0427a9eafee540f7492e3a5b/_/images/icons/emoticons/error.png

The Scroll Page Title of the source page won't overwrite the Scroll Page Title of the target page.

Attachments

Partially ⚠️

The attachments on the target page will be removed from the editor and page views, but the original attachment will remain in the attachment section of the page. Any new attachments added via the overwrite feature will be be added in both the editor and the attachment section.

Macros

Yes https://k15t.jira.com/wiki/s/-2050679084/6452/aedacba96270a5dc0427a9eafee540f7492e3a5b/_/images/icons/emoticons/check.png

Any macros present on the target page will be removed upon overwriting. If the source page contains any macros, those will be added into the page you are overwriting.

If the source page contains any Include Page, Insert Excerpt , or MultiExcerpt Include macro you’ll have the option to resolve these macros during the overwrite process.


Links

Yes https://k15t.jira.com/wiki/s/-2050679084/6452/aedacba96270a5dc0427a9eafee540f7492e3a5b/_/images/icons/emoticons/check.png

Any links on the target page will be removed and replaced with the content from the source page. If the source page has external and internal links, those will be added to the target page.

When copying internal links between versions, they will be automatically transformed to direct to the corresponding page within the same version, if the page is present in that version.

If you copy an internal link to a version where the linked page does not exist, the link will direct back to the linked page in the source version.


Page labels

No https://k15t.jira.com/wiki/s/-2050679084/6452/aedacba96270a5dc0427a9eafee540f7492e3a5b/_/images/icons/emoticons/error.png

The page labels on the target page will not be replaced by the labels from the source page.

Things to keep in mind

Even though the process of copying content is relatively straightforward, there are certain points and limitations that need to be taken into consideration before using the feature:

  • Single version update: Content can only be overwritten from one page to one version at a time.

  • Cannot be used for merging: The feature always overwrites all content of a page. It’s not possible to only overwrite specific sections of a page, thus we do not consider this a merge feature.