The Insert Asset button does not appear in the editor
The button is injected into CKEditor 4 instances on admin pages. Check that:
- you are on an admin page, not the public site,
- the editor is Omeka's CKEditor 4, not a different editor provided by another module, and
- the page was loaded after the module was installed and activated.
If a module or theme replaces Omeka's CKEditor configuration wholesale (rather than extending it), it may drop the assetpicker plugin from extraPlugins. The module listens for Omeka's o:ckeditor-config event, so configurations that go through that event keep the button.
Replace was rejected with an extension error
The replacement must have the same extension as the original file, because the extension is part of the asset URL. Convert the image to the original format, or upload it as a new asset and update the pages that use it. See Replacing Files.
I replaced a file but still see the old image
The URL did not change, so your browser or CDN is serving a cached copy. Reload the page with the cache bypassed (Shift+Reload) or purge the URL from the CDN. The file on disk is already updated.
An upload fails or the file type is not accepted
The library accepts JPEG, PNG, GIF and WebP. Uploads are also subject to Omeka's own media upload settings under Settings > Security, and to your PHP upload_max_filesize and post_max_size limits. Very large images usually fail on the PHP limits; raise them or resize the image first.
A user gets "Access denied" from the API or cannot see some buttons
The library follows Omeka S's own asset permissions. Authors can change and delete only the assets they own, and reviewers can change anyone's but delete only their own. Creating, renaming and deleting folders is for editors and above. Buttons a person can't use are hidden, so an author sees no New Folder button, and someone else's asset opens read-only. See Configuration for the full permissions table.
Select opens Omeka's own list of assets instead of the window
The window replaces Omeka's list only when it can load the library. Omeka's list opens instead for someone whose role may not use the Asset Library, and whenever the library's assets can't be loaded, for example after a server error. Check that the person is an author or above and that the Asset Library page opens for them.
Does deleting a folder delete its assets?
No. The assets become unfoldered and stay visible under All Assets. Sub-folders are not removed with their parent; delete or move them first.
Where do uploaded files go?
Into Omeka's normal file store, exactly as if you had uploaded them from Admin > Assets. The module adds folder and usage records in its own tables but does not move or copy files.
Does uninstalling delete my assets?
No. Uninstalling drops only the module's own tables. Assets remain in Omeka's asset table and on disk, and pages that use them continue to work.