View Full Version : Error on epubcheck

01-29-2011, 06:19 AM
I'm getting an error on epubcheck. it says: WARNING: My Book.epub: item (iTunesMetadata.plist) exists in the zip file, but is not declared in the OPF file.

I have no idea what this means. This is my first attempt at publishing an ebook. Any suggestions?

01-29-2011, 08:08 AM

Welcome to Mobileread ....

I'll get this post moved to the ePub Forum and someone will answer

- At first glance at your error it suggests that a file exists but you have no specific reference to the file in the .opf. Each and every file in the epub/zip folder must be mentioned in the .opf.

See this in our Wiki (

01-29-2011, 10:19 AM
That particular fie gets dumped in by the iTunes processing. It shouldn't, of course, but that's Apple. I think Liz Castro discusses this problem on her blog ( You may have search a bit, but reading the whole thing is not wasted time.

01-29-2011, 12:23 PM
Yes, that file gets added to an ePub if you view it using iPad, iTouch, etc, or if you run it through the iTunes publishing application.

Simplest solution would be to change the .epub file extension to .zip, open the zip file, find and delete the iTunesMetadata.plist file from the zip archive, close the zip file, then rename the extension back to .epub.

If you want to view/check an ePub on an Apple device, best to make a copy of the ePub and view that, so that the original remains untouched and doesn't get that iTunesMetadata.plist file added to it.

08-31-2011, 06:36 AM
I too just got that same error:
"iTunesMetadata.plist exists in the zip file, but is not declared in the OPF file"

I omitted the file and my ePub validates. And will be looking at both versions (with and without) later today on an iPad. Question: If I wanted to include it in the .OPF file, how is that done?

Thank you.

09-01-2011, 03:17 AM
Karma to Donna for suggesting a way to prevent the insertion of the file, and to Mignon for asking how to get ePubCheck to accept it.

By the way, FlightCrew doesn't object to the thing.