Recommended releases

Download Released

Utility module to fix the odd situation that managed files have a status of
"permanent" but no usage record.

How could this happen?

There are multiple reasons for that, the most common is upgrading from
Drupal 7, which didn't handle files the way Backdrop CMS does (managed, with
usage records).
Usage counts of files and images only used inline, for example inserted into a
WYSIWYG editor in D7, aren't handled yet when upgrading, so these files end up
in this odd state.

How can you know that your site is affected?

Trying to use such files in the editor via Image library will end up with a form
error "The file used in the Upload an image field may not be referenced.".

To verify, go to admin/content/files and sort by "Use count" (ascending).
You'll find files with state "permanent", but without usage count.

What can you do about it?

Install this utility module, go to admin/content/fix-file-usage, and submit the form.
Depending on the amount of affected files (more than 5000?), you might have
to repeat that step multiple times.

When you're done, you can safely uninstall this module again.

You can now reference any of the available files.

Related core issue: backdrop/backdrop-issues#3857

Installation

Issues

Bugs and feature requests should be reported in the
Issue Queue.

Current Maintainers

License

This project is GPL v2 software. See the LICENSE.txt file in this directory for complete text.