[Plugin] EditMetaInEPUB3 - Manage legacy meta entries in the EPUB3 metadata

[BeckyEbook]

Updated: July 28, 2026
Current Version: 0.0.9
Status: Experimental
Plugin type: edit

Plugin icon:


How it works:
This plugin provides a simple editor for legacy EPUB2-style metadata entries stored in an EPUB3 package document as:

<meta name="..." content="..."/>

According to the EPUB3 specification, these legacy metadata entries are ignored by EPUB3 reading systems and are intentionally not editable in Sigil's built-in EPUB3 Metadata Editor. However, they are still preserved in EPUB3 files and are used by some third-party applications and workflows.

Instead of manually editing the OPF file, this plugin allows you to safely manage these legacy metadata entries through a dedicated table-based interface.

This plugin was inspired by a MobileRead discussion about editing legacy EPUB2-style metadata preserved inside EPUB3 package documents.

The plugin:

• Displays all legacy meta entries that use the name and content attributes.
• Allows adding, editing and removing legacy metadata entries.
• Ignores protected entries used internally by Sigil (such as cover).
• Preserves legacy metadata entries exactly as entered.
• Warns before closing the window if there are unsaved changes.
• Prints a concise diagnostic log to the plugin console.

Important:
This plugin only edits legacy metadata entries stored as:

<meta name="..." content="..."/>

It does not edit standard EPUB3 metadata (such as dc:title, dc:creator or meta property="..." entries), which are already supported by Sigil's built-in EPUB3 Metadata Editor.

Installation:
1. Select Manage Plugins from the Plugins menu. In the Manage Plugins dialog box, select Use Bundled Python, if it isn't already selected. (If your Sigil version doesn't have a Use Bundled Python option, click one of the Auto buttons to detect the path or Set to manually select the Python interpreter path.)
2. Click Add Plugin and select EditMetaInEPUB3_v0.X.Y.zip. This will install the plugin, which you can then run via Plugins > Edit > EditMetaInEPUB3.

Issues:
This plugin is intended for advanced users who understand the structure of EPUB metadata.

Only legacy meta name/content entries are modified. Existing EPUB3 metadata, Dublin Core elements and meta property entries remain untouched.

Please report bugs or suggestions in this thread.

OS Requirements:
Windows/Linux/OS X.
Tested on Windows 10 and 11 with Sigil 2.8.1. It should also work on Linux and macOS.
*** Linux users will have to make sure that the PySide6 module is present if it's not already. ***

Sigil Requirements:
Minimum version of Sigil: 1.0.0 [not tested]

Credits/Thanks:
KevinH – for encouraging this plugin idea.

License/Copying:
GNU LGPL Version 2 or Version 3 your choice. Any other license terms are only available directly from the author in writing.

The plugin is currently in the Experimental stage, so I’m looking forward to your feedback. If no issues or bug reports come up within the next week or two, I will mark the plugin as Stable.

[BeckyEbook]

(Reserved for future use)

[KevinH]

Added to the Sigil Plugin Index. Thank you!

[philja]

Installed and tested on MacBook Sigil 2.8.1 and Linux also 2.8.1 AppImage version. Superficial testing only, but the plugin works as defined.

EDIT: the discussion about plugins opening on different desktops on macOS has been moved here: https://www.mobileread.com/forums/sh...d.php?t=374655