Convert standalone article to synced article

If you have an existing article you'd like to convert to a synced article, you can use one of two approaches:

  1. Copy the permalink for the standalone article, delete the standalone article, and create a new synced article with the same permalink as that deleted standalone article.
  2. Power users only: Use the API to forcibly convert the existing standalone article to a synced article.

If you're familiar with using the API, convert an existing article to a synced article using these steps:

  1. Get the ID of the article you'd like to switch to being the synced child and the ID of the article you'd like to make its parent.
  2. Follow the API endpoint reference guidelines on the articles endpoint to Update a single article.
  3. Update the child article and set the content_article field to the parent article's ID.

When you use this approach, if the child article had any existing content:

  • You will no longer see Revision History in the UI for changes to the child article's content.
  • Even in the API, the child article will not keep revisions moving forward.
  • If you have historical revision history for the child article, it won't display in the UI. You can recover or view it using the articlerevision API endpoint.
  • If you unlink the articles through the UI or setting the content_article field to be empty, this returns the article to standalone status and will display the pre-sync revision history for the child. The child article won't ever display revision history when it was synced to the parent since revisions are stored on the parent only.