FAQs Omeka Classic theme

Troubleshooting

Why don't the colors look exactly like the ones I chose?

Plinth darkens or lightens a color wherever text in that color, or on that color, would be hard to read, keeping its hue.

Why is a work's label empty, or missing lines?

The wall label reads Creator, Title, Date, Medium, Extent, Provenance, Identifier and Abstract or Description. Medium, Extent, Provenance and Abstract come with the Dublin Core Extended plugin: install it, then fill in those elements. Check that Item pages › Wall label is on. See Item pages and wall labels.

The artist's name in a label isn't a link, or has no dates.

The label looks for an item of the item type Person (or Organization, or Agent) whose Title is exactly the work's Creator, and shows that item's Date as the artist's dates. Spell the name the same way in both places, and give the artist's item a Date.

An artist's page doesn't list their works.

Item pages › An artist's works lists the items whose Creator is exactly the artist's Title, on an item of the item type Person, Organization or Agent. Check the spelling, the item type, and that the works are public.

My work's page shows the title twice, or no title.

When a work and its wall label are on the page, the label is the visible title. With the wall label off, or on a work without any label values, the page's own title shows instead.

Why are my grids in plain rows?

Staggered columns and rows of equal height are arranged by Plinth's script. If it cannot run (an old browser, or scripts turned off), grids show as plain rows of works, every work whole. Even squares need no script.

The header over the image doesn't float on my page.

It floats only on the home page, over a banner with a picture, when Home page › Banner style puts the text over the image or below it. Elsewhere it is a top bar. Upload a Logo for dark mode so a light logo shows on the dark band.

My logo, banner or icon won't upload.

The Configure Theme page accepts PNG, JPG and GIF files up to 1 MB: SVG files and larger images are refused, with a message beside the field. Save a smaller PNG or JPG. For a large banner picture, add it to an item and use Home page › Banner image from an item. If even small files fail, your server's PHP upload limit (upload_max_filesize) may be lower than 1 MB: ask your host.

Works look small or soft on their pages.

Item pages and banners from items show Omeka's full-size copy of each image, at most 800 pixels wide by default. Raise Fullsize Image Size under Appearance › Settings (to 1600 or 2000) and add the images again; Omeka makes its copies when a file is added. The image viewer always opens the original.

My logo disappears in dark mode.

Add a light version of the logo under Dark mode › Logo for dark mode.

A Simple Page lost its content classes when I saved it.

Two things in Omeka rewrite HTML when you save. On a Simple Page with Use HTML editor? ticked, the editor can drop or rearrange the markup a content class needs: untick it for pages built with content classes and edit the HTML directly. And Omeka's HTML filter (Settings › Security) removes elements and attributes that are not on its allowed lists, including the images and figures a banner or a picture gallery needs. See Simple Pages and content classes.

My settings don't apply to an exhibit.

The exhibit has a theme of its own: on its edit page, Exhibit Builder's Theme is set to a theme rather than Current Public Theme, and its settings replace the site's on its pages. Change them there with Configure, or choose Current Public Theme. See Exhibits.

I changed settings in Design Studio, but visitors don't see them.

Design Studio keeps your changes as a draft that only you see until you click Publish.

The site still looks the same after I changed something.

Settings take effect as soon as you click Save Changes. If you still see the old design, your browser, a caching plugin, a proxy or a CDN may be showing a stored copy: reload the page while holding Shift, or clear that cache.

The site loads a script from code.jquery.com.

Omeka Classic itself loads jQuery from code.jquery.com on every public page, whatever the theme. To serve Omeka's own copy instead, set theme.useInternalAssets = true in application/config/config.ini. Plinth adds no other outside requests, unless you choose a font from an outside service.

Why is my link preview on social media missing an image?

Upload a Default sharing image under Site icon & sharing. Social networks keep previews for a while; their sharing debuggers can refresh them.

How do I show the site in my language?

See Languages and translation.

A plugin's page doesn't match the theme.

Many plugins have templates or styles in the theme: see Plugin integrations. Every other plugin's pages inherit Plinth's text, forms and buttons. If something looks out of place, adjust it under Advanced › Custom CSS using the design tokens, and tell RefBytes which plugin and page it is.

Log in for Support