September 8, 2021
February 1, 2022
This article describes the removal of the Google Docs Importer for all Zendesk customers and covers the following topics:
What does this mean?
Effective February 1, 2022, Zendesk will no longer provide the ability to Import Google Docs into the Guide knowledge base.
Why is Zendesk removing this?
Over the past few years, we have monitored overall usage and feedback related to this feature, and we are removing this functionality as a result.
Our original intent was to help customers import articles into their knowledge base. The formatting of Google Docs content is often difficult to maintain on import. Google Docs uses a proprietary format that does not translate well to HTML, which is the base format for help center articles. This can cause issues with tables, lists, drawings, comments and other types of objects – requiring the author of the imported article to reapply styling and fix broken links or images. Ultimately, this has left customers frustrated, which does not align with the experience Zendesk ultimately strives to provide for you. We have also found that very few customers are regularly using this feature as a result.
For these reasons, Zendesk recommends customers consider the alternatives listed below.
What are the alternatives?
There are a few alternative ways to import the content to your Guide knowledge base.
- If you are in the early stage of onboarding to Zendesk, we recommend exploring the Help Desk Migration App, (see Listing on Zendesk Marketplace) or enlisting Zendesk Professional Services. Both options are paid, and can provide you with comprehensive migration capabilities beyond just knowledge base articles. This includes things like tickets, users, custom fields etc.
- Another (free) option is an old fashioned copy and paste. This is suitable for cases when you need to bring small amounts of content into the knowledge base. Copy and paste has some advantages compared to the Google Docs Importer. It will not create a new article every time as the importer does today. It will also not break links and formatting is usually better-preserved.
- In partnership with a developer, you can also build your own custom importer based on the Guide article API (see Migrating existing content to your help center, Guide API - Create Article). This can be tailored to your particular needs.
Who is affected by the change?
Google Docs Importer is currently available only for customers who joined Zendesk before April 20, 2021, and will be completely removed from all help centers effective February 1, 2022.
We’re offering an extension for the Google Docs Importer while we complete enhancements to the Guide article editor. Only customers with access to the Google Docs Importer before April 20, 2021 are eligible for the extension. You must sign up using this form by February 1, 2022.
One possible alternative (though it also requires effort), would be to use this (paid) third-party app, which allows up to 1000 articles to be imported via CSV file (the documentation states that HTML can be included in the body field of the CSV file to be imported, but you'd need to convert your google docs to html and build the CSV file). I'd recommend checking with the app developer if you have any questions as to how this would work with your files -- there's a contact link here: Help Center Import
Jennie Grudi I would suggest you take a look at some of the apps we have in our Marketplace like:
Hi Ryan - checking back for an update here on the improved copy-and-paste image experience. Our team is not able to successfully copy images from the Google Docs we use to edit our articles before adding them to Zendesk over a year after your last update. Please let us know if the fix for this is coming soon.
Please sign in to leave a comment.