The Zendesk help center doesn't support publishing one article in multiple locations out of the box. However, the help center API allows you to build a small application that publishes and syncs copies of a single article in multiple locations within your help center, or in any branded help center in your Guide Professional plan.
Use the help center API endpoints to publish and sync copies of an article. Follow the below steps to achieve this workflow.
Step 1: Create a copy of the article
Use the GET
and POST
requests to make copies of the source article in another help center location.
To create copies of an article
-
Make a
GET
request to get the source article's dataGET /api/v2/help_center/{locale}/articles/{article_id}.json
See Show Article in the developer docs.
-
Make a
POST
request to create a copy using the data from theGET
requestPOST /api/v2/help_center/{locale}/sections/{section_id}/articles.json
See Create Article.
Step 2: Sync the copies with the source article
Use the GET
and PUT
requests to periodically sync the copies when the source article is updated.
To sync the content
-
Make a
GET
request to get the current content of the source articleGET /api/v2/help_center/articles/{article_id}/translations/{locale}.json
See Show Translation in the developer docs.
-
Make a
PUT
request to update the article copy using the data from theGET
requestPUT /api/v2/help_center/articles/{article_id}/translations/{locale}.json
See Update Translation.
What's next
To learn how to build a copy-sync application with these endpoints, see Mimeo, a command-line application on Github. Start with the project's documentation, then clone or download the source code to see how it works. You can also modify or extend the application any way you want to build your own solution.
For more information, see the article: Reusing content with content blocks.