HTML Zip export

Create an HTML Zip export of your knowledge base for use as a back-up.

Overview

The HTML Zip export creates a zip file containing files for each of your articles and folders for each category/subcategory. The export will also include an "images" folder at each level, which contains all the image files uploaded to your File Library and referenced in your articles, and the articles linked to those images will update to that path (images/file-name) rather than the URL used in your File Library.

You can decide whether to include articles in a draft publishing state.

You can use this zip export for:

  • Back-ups (for redundancy, piece of mind, or audits)
  • Exporting your content for import into another tool/platform

You can regenerate and download an updated HTML zip file at any time. You can also download a previously-generated export without generating a new one.

Creating an HTML Zip export

To create an HTML Zip export of your knowledge base:

  1. Go to Knowledge Base > Exports.
  2. Open the HTML Zip tab.
  3. By default, exports will not include draft articles. Check the box next to Include draft articles to include them.
  4. Click the Save and Regenerate HTML Export button to generate a new HTML export. Once you click this button, a progress bar will appear. The message here will go through a few stages:
    1. HTML export queued
    2. exporting xxx articles to HTML
      Sample progress bar
    3. generating zip file
    4. uploading zip file to server
  5. Once generation is complete, a success message will appear:
    Sample HTML zip generation success message
  6. Click the Download button to download the zip export file. You can come to this page at any time to download an already-existing export, or generate a new one each time.
  7. The "Last generated on" statement will show you the timestamp of the last generated export.

HTML export of categories with question marks in the title

If you have categories or subcategories with question marks in the title and you try to access those files on a Windows machine, you may notice some unusual behavior with them.

Why?

Windows does not allow folders to have question marks in them. It doesn't care where those folders come from--it doesn't handle them.

If you're using Windows' built-in zip/unzip tool to interact with zip files or unzip them, you won't see categories or subcategories with question marks in the title.

Don't worry, though! The categories and subcategories are there and were properly exported--Windows is just hiding them from you because it can't handle question marks.

How do I fix this?

For Windows users, there are two ways to bypass this issue:

Option 1

Restructure your category names so they don't have question marks. This works, but obviously there may be reasons you don't want to do that.

Option 2

Use a zipped file tool that can handle the question marks. We've had great luck with 7zip, which is a free, open-source solution. When you use 7zip to extract the files from a zipped folder and you have categories with question marks in them, it will create the category as a folder and replace the question mark ("?") with an underscore ("_") instead. All your content will still be accessible.

So if my original category was "How do I make changes to my account?", once I've extracted that category in 7zip, it will show up as "How do I make changes to my account_".

Even better, if you set 7zip to be the default application for .zip files, you can double-click a zipped folder without unzipping it to navigate the content, and you'll be able to see the category with the question mark directly there.

7zip navigation into .zip file shows the question mark

Zipped folders in this scenario will have a little Z icon over them:

.zip file display when 7zip is your default application for .zip files