Google Docs — Migration Reference

Google Docs — Migration Support Overview

Role in migrations

• Category (KB): supported as source.
• Folder (KB): supported as source.
• Article (KB): supported as source.

Field-level support migrating FROM Google Docs (Article)

Migration options available for Google Docs

• No specific migration options documented.

Google Docs Migration Peculiarities

What entities can be migrated?

Users can migrate:

• From folders where the Google account acts as the Owner.
• From shared folders where the Google account has Edit or Comment permissions.

Google Docs Structure Mapping

The folder selected as the Folder during the Google Docs connection functions like a workspace — it is neither a category nor a folder itself.

The folder selected at the Source step is the Google Drive folder from which all internal folders are read. First-level folders become Categories; everything below that level becomes Sections.

For example, the following hierarchy on Google Drive:

Produces this hierarchy on the Target:

• Category — Level 1
• Sections — Level 2, Level 3, Level 4

If there are articles in the Source folder or at Level 1, they will migrate into the default folder and default category on the target.

Ideal structure:

1. Workspace — the folder selected during the connection
2. Category — a folder created inside the workspace
3. Folder — a folder created inside the category
4. Articles — Google Docs files created inside the folder

One Google Doc equals one article. If a client has all their articles collected in a single Google Doc, they cannot be custom-split into separate articles during migration (even if a table of contents is set up) — check with engineers if this comes up.

Conclusion: the source needs a minimum of 3 levels of "folders" plus the articles themselves.

Naming requirement

Category and section names cannot consist of numbers only, or the migration will fail. A combination of text and numbers migrates without issues.

How to Split a Single Google Doc into Multiple Articles

If a client has all their articles in one Google Doc, they can be advised to split it using Google Docs' outline feature.

Video guide on Youtube: https://www.youtube.com/watch?v=KAULLhm8GFQ

Steps:

1. Open the document containing all the articles.
2. Apply the Heading 1 style everywhere you want to split the document.
3. Once done, go to the View tab and click Outline.
4. Click anywhere in the text, press Ctrl+A, then click Show Document, followed by Create.
5. Save the document, then open the folder on your computer where it was saved. Each article should now be saved as a separate document, split according to where you applied the Heading 1 style.
6. Upload the individual documents to Google Docs.

Note: If you make changes to a child document created this way, the parent document containing all the articles will also be updated.