Troubleshooting Ghost Imports

Below is a comprehensive list of the most common import errors you may encounter while attempting to import your data into a Ghost blog. If you need help creating a file to import into Ghost, we've put together a guide that will walk you through how to import and export your Ghost blog settings and data.

Validation errors

Value in [posts.title] cannot be blank. Value in [posts.slug] cannot be blank. Value in [settings.key] cannot be blank. Value in [tag.name] cannot be blank. Value in [tag.slug] cannot be blank. Any one of the error messages listed above indicate that something is missing. Your Ghost JSON file contains a meta block, and then a larger data blog, that has a structure similar to this:


"data": {
               "posts": [{..},..],
               "tags": [{..},..],
               "posts_tags": [{..},..],
               "settings": [{..},..],
}

When you receive a validation error, the message will contain the object and the field inside the brackets. So, for example, the error message "Value in [post.title] cannot be blank." means that you've got an empty post title somewhere within the data block of the JSON file. Validation (isUUID) failed for uuid This particular validation error is caused when the UUID in the file is not a real UUID. To handle this error, it's best to delete the UUID completely.

Duplicate entry errors

Duplicate entry found. Multiple values of "tagging-things" found for tags.slug. Duplicate entry found. Multiple values of "tagging-things" found for tags.slug. Duplicate entry found. Multiple values of test-ghost-post" found for posts.slug. "Duplicate entry found." error messages indicate that there are two of the same "thing" somewhere within the JSON file where it is not allowed. For example, if you receive the error, Duplicate entry found. Multiple values of "Recipes" found for tags.slug. it means that there were two tags found with the same name of "Recipes" - meaning that you will need to find and locate the duplicate and rename it "Recipes-2" (or change it to something different).

Other common import error messages

Please select a file to import
Error is returned when you attempt to import without choosing a file.

Please select a .json file to import
Error is returned when you try to import a file that has a different extension.

Fail to parse the import JSON file
Error is returned when the JSON contained within the file is invalid (for example, the JSON file is missing a quote or brace).

Import data does not specify version
Error is returned when the version number is missing from the meta bock, or the meta block is missing.

Unsupported version of data:###
This particular error is returned when the export file is too new - i.e. you are trying to import your data from a newer version of Ghost into an older version.

Tip: If your export is too new, you can normally open the JSON file, change the version number to a lower number and it should work.

Attempting to import data linked to unknown user id #
Error is returned when the import contains user ids without corresponding users.