Modules & Themes

Uploading your own modules and themes

The built-in catalog covers the official directory, but maybe you have something of your own: a module you built, a theme you commissioned, or a plugin you bought somewhere else. You can bring those into Platform Manager too. Register it once for your team, and from then on it shows up in the Available list on any matching site, ready to install with one click.

Register the module or theme

Head to the My Modules or My Themes page in the menu and create a new entry. The form asks for a few things:

  • Platform. Whether this is for Omeka Classic or Omeka S. It will only be offered to sites on that platform.
  • Name. A friendly name, shown in your lists.
  • Directory Name. The name of the folder inside your zip file. This one matters: it has to match the folder in the zip exactly, and it cannot be changed later, so double check it before saving.
  • Enabled. Leave this on so the item appears in your sites' Available lists.

📷 Screenshot: The new module form showing the Platform, Name, Directory Name, and Enabled fields.

Upload a version

Registering creates the entry, but it does not have any files yet. Open your new module or theme and add a version by attaching a ZIP file. This is the same zip you would use to install into Omeka by hand, so if you downloaded it from a developer or built it yourself, you can upload it as-is.

You do not need to type a version number. We read the version number straight from the zip, from the standard config file every Omeka plugin, module, and theme includes. If the zip does not contain that file where we expect it, the upload is rejected. When that happens, the usual culprit is a Directory Name that does not match the folder inside the zip.

📷 Screenshot: The version upload form with a zip file attached and the detected version shown.

Install it on your sites

That is the whole process. Open any site on the matching platform, go to its Modules or Themes tab, and your upload is waiting in the Available list. Installing works exactly like items from the catalog, which is covered in Installing modules and themes.

When a new version comes out

When you have an updated zip, come back and upload it to the same entry. Every upload adds a new version, and each of your sites can choose which version to run. See Managing versions for how that works.

Log in for Support