Skip to main content
cedi editoração 01
Participant
Feb 10, 2025 8:46 PM UTC
Answered

Apple Books validation error for EPUB

Hi,

 

I'm trying to upload an Epub to the apple store as I've been doing for years, but now I'm getting this error:

ERROR ITMS-9000: epub_igualdade_racial_7ed.epub: OEBPS/content.opf(28): [OPF-027] Undefined property: 'pageBreakSource'.

The pageBreakSource export option is a new feature added in the 2025 version. It's manly for epubs based on a printed version. I can validate the Epub with no errors in epubchecker. I don't want to create an extra epub only for Apple. Is anyone getting this same error?

Laura BradyCorrect answer
Inspiring
Feb 11, 2025 3:26 PM UTC

You could simply add a page source. This can now be done at export by adding an ISBN to the EPUB export wizard, on the first panel of the export suite of options. The main issue here is that InDesign is exporting it with specific metadata that some vendors are rejecting. To fix it, add this to the OPF of your ebook: <dc:source>9780000000000</dc:source>.

6 replies

Inspiring
Mar 7, 2025 12:29 PM UTC

I've been getting a similar error:

 

ERROR: OEBPS/content.opf(23,49): Undefined property: "pageBreakSource".

 

The only way I've been able to fix it has been to uncheck the page navigation option on export from InDesign. It would be nice to use the ISBN from the physical book as the source, but quite often text will move in the InDesign document when we prepare the EPUB. I'd rather not use the feature unless I know it' accurate.

Translate
Inspiring
Mar 7, 2025 12:32 PM UTC

You need to update the version of EPUB Checker that you are using. This isn't an error and has very recently been fixed. 

https://pagina.gmbh/startseite/leistungen/publishing-softwareloesungen/epub-checker/

Translate
Participant
Mar 7, 2025 12:41 PM UTC

Thank you, Laura. I should have noted that I don't get the error myself (I use epubcheck 5.2.1). It's when our clients try to upload to a specific vendor that they get the error. I'll inform the vendor that they should update the checker they use. Again, many thanks.

Translate
Laura BradyCorrect answer
Inspiring
Feb 11, 2025 3:26 PM UTC

You could simply add a page source. This can now be done at export by adding an ISBN to the EPUB export wizard, on the first panel of the export suite of options. The main issue here is that InDesign is exporting it with specific metadata that some vendors are rejecting. To fix it, add this to the OPF of your ebook: <dc:source>9780000000000</dc:source>.

Translate
James Gifford—NitroPress
Legend
Feb 10, 2025 10:17 PM UTC

First, it's not too uncommon to have to tailor EPUB exports to each sales portal. Where a generic export might be possible, it doesn't always make the best of each platform/reader's features.

 

The page navigation markers are, as you note, new, but with the 2024 (v19) version. You can turn them off by unchecking Page Navigation in the EPUB export menu. As far as I know, no reader or platform demands these (yet), so that same version should pass validation on all sales portals.

Translate
Inspiring
Feb 11, 2025 3:27 PM UTC

That is terrible advice. Why would you counsel people to hobble their ebooks like this? 

Translate