Below are some common errors from Kobo eBook failure reports.
Adobe ACS Errors
| Error: | Explanation |
| Invalid dates provided in the OPF file | A date specified in the ePub OPF file is invalid. Dates must be provided in the following format: YYYY-MM-DDTHH:MM:SSZ Please check the following places and revise as necessary: <dc:date> <meta property="dcterms:modified"> |
| ePub file size exceeds processing limit. | The ePub file provided was too large for the system to successfully process. Please reduce the overall size of the ePub file, as it is currently too large to be ingested in Kobo's system. Reducing the file size of any images inside the ePub is recommended. You can view Kobo's suggested file size for ePub components. |
| File was not able to be unzipped. Please rezip the file and redeliver to the FTP. | The ePub file may have been incorrectly zipped or was corrupted during the zipping process. Please try rezipping the file, ensuring that the mimetype file is the first one in the zip document. You can also try running the newly-zipped ePub file through an ePub validator to see if the zipping error is corrected. Once the file is rezipped, please redeliver it to your FTP. |
| Document Type Declaration incorrectly declared in the .NCX file | There is an issue with the DTD (Document Type Definition). Please make sure you have included a .ncx file and the following information is included: - the version - the language - the namespace declaration Example of a correctly formed DTD: <ncx version="2005-1" xml:lang="en" xmlns="http://www.daisy.org/z3986/2005/ncx/"> |
ePub Errors
| Error | Explanation |
| Duplicate entry provided in OPF file: $value |
The OPF file is referencing itself. The OPF file is a manifest of all the files in the ePub and it is redundant to reference itself. Please remove the reference to the OPF file within the OPF file itself, rezip the ePub, and redeliver it to your FTP. |
| The file received was 0 bytes. Please redeliver the file. | The file we received is 0 bytes. There may have been an interruption in service during the transferring process, or there may have been an issue copying the file to the FTP. Please try delivering it to your Kobo FTP again. |
| Unable to decrypt fonts due to missing dc:identifier |
The <dc:identifier> in the OPF file does not contain an acceptable font decryption key. In order to properly decrypt the fonts the primary identifier must begin with a letter (A-Z) and may be followed by any number of numerical digits (0-9), letters, hyphens (-), underscores (_), colons (:), and periods (.). Consider running your ePub file through a validator to further diagnose the issue. Please revise the ePub and redeliver to your FTP. Recommended reading: Kobo's advice on obfuscated and embedding fonts in ePubs |
| Obfuscated font file is empty: $value |
An obfuscated (encrypted) font file is empty or blank inside the ePub file. Please correct the ePub to include the corrected font file. If all the fonts are correct inside the ePub, check to make sure that the font file is correctly referenced in the OPF file with an identical file name, or that the font file is not missing from the ePub if it is referenced in the OPF. Please redeliver the revised ePub to the FTP. Recommended reading: Kobo's advice on obfuscated and embedding fonts in ePubs |
| Unable to process ePub due to no read access permission |
The ePub file has been zipped with permissions that do not allow our system to read the file. Please rezip the file without the permissions embedded and redeliver to the FTP. |
| Item exists in the ePub but is not declared in the OPF manifest: $value |
The file indicated is present in the ePub but is not declared in the OPF file. Please ensure that every file contained within the ePub is declared within the OPF. Please deliver the revised ePub to the FTP. |
| Could not extract ISBN from filename or OPF file: $value |
The eBook ISBN was not provided in either the file name of the ePub or within the OPF file. Kobo requires that the product's 13-digit ISBN is present in the file name for all ePub and image files. Our system uses the ISBN to match the metadata, epub and cover files together to make a complete product. Kobo can also pull the ISBN from the <dc:identifier> tag provided in the OPF file inside the ePub. However, filename is privileged more highly. Please rename the file to include the eBook ISBN and/or ensure the OPF file also includes the ISBN, and redeliver the file to your FTP. Correct: 9780145667123.epub
|
| Invalid character provided for dc:identifier: $value |
The <dc:identifier> tag is located in the OPF file of your epub. Kobo recommends using the ebook ISBN as the identifier, but an UUID can be used as the identifier if the title has obfuscated fonts. The identifier can contain letters (A-Z), hyphens (-), underscores (_) colons (:) and periods (.). Spaces are not permitted. The identifier must be at least 2 characters long. If your title has obfuscated (encrypted) fonts, in order to properly encrypt/decrypt the fonts the primary identifier must begin with a letter and may be followed by any number of numerical digits, letters, hyphens, underscores, colons, and periods. |
| Invalid XHTML entity provided: $value | You are using an XHTML entity that is not valid. Please check the spelling of the entity and make sure all letters are in the right case (XHTML entities are case sensitive). Please make the necessary corrections and resubmit the ePub to the FTP. |
|
Invalid identifier provided for dc:identifier: $value.
|
The <dc:identifier> tag is located in the OPF file of your epub. The identifier must be at least 2 characters long and have an even number of characters. |
|
Content stored outside of OEBPS folder within ePub file: $value
|
The ePub failed to validate because a file was detected outside the OEBPS folder inside the ePub zip file. The ePub zip file should contain the mimetype file, the META-INF folder and the OEBPS folder, without any loose files outside of these folders. Files such as the .OPF file, the .NCX file and the CSS, HMTL, fonts, and image files should all be contained within the OEBPS folder. Consider running your ePub file through a validator to further diagnose the issue. |
|
ePubCheck is unable to process this file due to a bug with the EpubCheck validator
|
There is a bug with the ePubCheck validator that prevents this file from being validated. This issue won't be fixed until the validator bug is resolved. We suggest making a minor change to the ePub file and revalidating. |
|
Error at row: $value, col: $value
The end-tag for the element type "platform" must close with a ">".
|
To correct this issue, please ensure that the end tag is closed at the referenced line and column. |
Metadata Errors
| Error |
Explanation |
| No valid BISAC code provided. |
There is no valid BISAC code provided in the metadata update. All products require at least one valid BISAC code or other categorization code. Kindly resubmit the metadata for this title including at least on categorization code. BISAC codes are alphanumeric and must have nine characters. The first three characters must be letters while the remaining six must be numbers. Please ensure you are sending BISAC codes with a Subject Scheme Identifier code of 10. BIC codes may be submitted with the Subject Scheme Identifier of 12. Keywords may be submitted with the Subject Scheme Identifier of 20. Our system is not able to read category codes submitted under different Subject Scheme Identifiers. If you are not sure where to find a valid BISAC code to categorize your title, kindly consult the BISG website. Correct: Incorrect: |
| Invalid Product ID provided: $value. |
Please ensure your Product ID is a 13-digit ISBN. Kobo accepts the following ProductIDTypes: 03, 15, 02, 01 |
| No Publishing Status provided. |
Kobo requires a value for Publishing Status. Please select a value from Code List 64. Kobo uses 02 (forthcoming) and 04 (active) as active Publishing Status values. All other values will deactivate a title. |
| Invalid price provided: [0.01] | Kobo does not accept books priced at 1 cent because the processing cost is greater than the book's price. Please send in an updated price or consider making this title free. |
| Price must be a whole number for [XYZ] currency code. Received $Value |
JPY, MXN, and TWD prices need to be a whole number and not contain commas or decimal places. Correct: 100 JPY |
| Invalid date format provided: $value. Please ensure all dates are formatted as YYYYMMDD |
Please ensure all dates are formatted as YYYYMMDD in your ONIX. Our system is not able to read dates formatted in other ways. Incorrect: YYYY/MM/DD, DD/MM/YYYY, YYYY-MM-DD |
| The ExtentUnit value $value provided is not supported for duration extent. Supported ExtentUnit values for duration extent are [04, 05, 06, 14, 15, 16]. |
Kobo only supports codes 04, 05, 06, 14, 15, 16 for duration ExtentUnit. At this time, no other codes are supported. Please refer to Code List 24. |
| No Currency Code provided for $value. |
No currency code was provided for a price in your metadata update. Each price amount must also have a currency code. Please refer to ONIX Codelist 96 for a complete list of currency codes. Please redeliver your metadata with an update currency code. |
|
<UnpricedItemType> tag is not supported for active products. Please send a price of 0.00 for free books.
|
Kobo does not support the <UnpricedItemType> tag for active products. Kindly send a price of 0.00 if you would like this product to be free. |
|
Unsupported Market Publishing Status provided: 00
|
Kobo does not support a Market Publishing Status value of 00. Please choose a different Marketing Publishing Status from Code List 68. http://bic-media.com/dmrn/codelists/onix-codelist-68.htm |
|
A product's metadata update cannot have both Kids and Adult BISAC codes.
|
According to metadata best practices, a book should not mix Kids or Young Adult and Adult BISACs, as each type of BISAC has a specific audience range in mind. Please redeliver your metadata with updated BISAC codes. |
|
Invalid date format provided: $value.Please ensure all dates are formatted as YYYYMMDD
|
Please ensure all dates are formatted as YYYYMMDD in your ONIX. Our system is not able to read dates formatted in other ways. |
|
Invalid preview percentage value provided: $value
|
The value supplied for the Preview % field is not accepted by Kobo. The value must be a number between 0 and 25 and must not contain a percentage symbol. Please submit revised metadata with a corrected preview percentage value. |
|
ONIX file is not encoded as UTF-8
|
Kobo strongly recommends the ONIX file to be encoded as UTF-8. UTF-8 is the default encoding for XML. Alternate encodings can cause problems with extended character sets. Example of ONIX header declaring UTF-8: <?xml version="1.0" encoding="UTF-8"?> |
|
The countriesincuded field for price $value $currency have duplicate country code(s)
|
The flagged price has duplicate country code(s). Each country code can only appear one time. |
|
XML declaration is not first in the file
|
The XML declaration isn't the very first thing in the XML file. This error indicates that there is something, possibly spaces, preceding the XML declaration. |
Audiobook Errors
| Error | Explanation |
| Image square request failed for product |
Kobo was not able to process the cover image. Please ensure the image meets the following conditions: -File name does not contain spaces or special characters -File name contains the ISBN -File is a valid JPG or PNG format -File was not inside a folder when uploaded to the FTP. Please correct the file and redeliver to your FTP. |
| Unauthorized to accept ebook metadata for audio book account |
Kobo is unable to process ebook metadata in an audiobook account. This account is set up to receive audiobook assets only. Please redeliver your file to the FTP for your ebook account, or deliver valid audiobook metadata for this title. If you do not have an ebook account and you would like to open one, please reach out to your Kobo Vendor Manger. |
| Edition Type of ABR/UBR is a required field |
A valid Edition Type was not provided. Kobo requires that all audiobook products specify whether the title is Abridged (ABR) or Unabridged (UBR). Please refer to ONIX code list 21 for a list of all Edition Types. Please note that only abridgement information is required for audiobooks. Please add the abridgement information to your ONIX and redeliver to the FTP. |
| Delivery for 2020_12_29T19_09_01_Z_manifest.json has not been completed after waiting 480 minutes. Files [xxx_xxx.mp3] was not delivered within 480 minutes. Please ensure that you upload all the mp3 files listed in the manifest. In addition, all the file names your audio files need to be an exact match to the file names listed in your manifest, including punctuation, spaces, and special characters. | Kobo was not able to process all of the files listed in your manifest within the time the system requires. Please redeliver your mp3 files and manifest to the FTP. |
| This audio file was not specified in the given manifest 2022_06_19T19_29_23_Z_manifest.json | The audio file specified was not listed in your manifest. Please check that all file names are listed in your manifest and the files names match those listed in your manifest. Once updated, please redeliver your mp3 files and manifest to the FTP. |
| kobo.exceptions.KoboIdException: java.lang.RuntimeException: Backup error for: StoreRestoreRecord | Due to an internal error your assets were not processed correctly. Please redeliver your mp3 files and manifest to the FTP. |
| Our system has privileged a more recent delivery of this. If you would like to replace this version please wait at least an hour to redeliver. . Recent File Used 2021_02_17T02_25_31_Z_018_Kink_Credits.mp3, Manifest 2021_02_23T02_57_17_Z_manifest.json | Kobo received more than one delivery of your assets within a specific time frame and has processed the earliest delivery. If your second delivery contained updated files and you wish to have those files replace your first delivery, please wait at least an hour and redeliver your assets to the FTP. Otherwise, no action is required. |
| System could not ingest /home/Books-rsync/xxxxxx_audio/incoming/xxxxxxxxxxxxx_zip. Please confirm that your filenames meet the agreed naming conventions to ensure we are able to successfully ingest your content. For internal reference: system attempted to create a manifest using the following regular expressions but found no matching pattern: ['^(\\d{13}|\\d{10})_(?P<index>\\d{1,4})(?:(.+))\\.(?P<ext>(?:mp3)|(?:m4a))$', '^(?P<index>\\d{1,4})(?:_(?P<chapter>.+))?\\.(?P<ext>(?:mp3)|(?:m4a))$'] |
*For Non-Manifest Audio Accounts where manifests are generated automatically by Kobo. This failure indicates that there is an error with the mp3 filenames. Your filename should follow the previously agreed upon naming convention so that the system can create the manifest/TOC. Please rename the files according to the agreed naming convention and redeliver your assets to the FTP. |
Cover Image Errors
| Error | Explanation |
| Could not extract ISBN from filename: $value |
Kobo requires that the product's 13-digit ISBN is present in the file name for all ePub and image files. Our system uses the ISBN to match the metadata, ePub and cover files together to make a complete product. Correct: 9780145667123.jpg |
| The file we received was 0 bytes. Please redeliver the file. |
The file we received is 0 bytes and was not transferred successfully to Kobo's system. There may have been an interruption in service during the transferring process, or there may have been an issue copying the file to the FTP. Please try delivering the file to your Kobo FTP again. |