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 folder buttons
Folder management, replace, bulk edits and delete require the editor role or higher. Authors and reviewers can browse, search, upload and view usage only. See Configuration for the full permissions table.
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.