Seeing where a media file is used and cleaning up unused files
Each media file's page shows where the file is used. Hipcall stops you from deleting a file that readers still see, and the Unused view lists the files you can safely remove.
Plan and permissions
- Plan: the media page is not limited to a plan.
- Permission: Customer service › Settings on the Roles screen. Account owners always have access.
Steps
See where a file is used
- Go to Settings › Contents › Media files.
- Click a file to open its page.
- Read the Where used section. It lists every place that uses the file, grouped under these headings:
- Attached to: a ticket, contact, company, task or deal the file is attached to.
- Knowledge base: articles, with a tag such as Published, Draft, Working copy or Revision 2.
- Learning: lessons.
- Processes: process working copies and versions, such as Published version 1.
- Click a line to open that article, lesson, process or record.
When nothing uses the file, the section says: "Not used in any article, working copy, past revision, lesson or process."
To change an image everywhere it is used, replace the file (the pencil on the image) instead of deleting it. Every page keeps showing the new image.
Find the files nothing uses
- Go to Settings › Contents › Media files.
- Next to All records, select the Unused view.
The list shows only files that are not attached to any record and are not used in any article, working copy, past revision, lesson or process. Ticket, contact and other record attachments never appear in this view.
Delete a file
- Open the file's page.
- In the Danger zone, under Delete this media, click Delete.
- What happens next depends on where the file is used:
- Used where readers see it, or where it will be published from. This covers a record attachment, a draft or published article, a working copy, a lesson, a process working copy or a process's current version. The dialog says This media cannot be deleted and lists those places. There is no delete button. Remove the file from those places first, then try again.
- Used only in past versions. This covers old revisions, old process versions, and withdrawn or superseded articles. The dialog lists them and warns you. Click Delete anyway to delete the file.
- Not used anywhere. Click Delete to confirm.
Deleting a file is permanent. It cannot be undone.
Common problems
The Delete button is missing from the dialog
The file is still used somewhere readers see it, or somewhere it will be published from. Open each place listed in the dialog, remove the image there, and try again. If you only want a different picture, replace the file instead.
I deleted a file and an old revision now shows a broken image
Past versions do not block deletion, so the image is gone from them too. If you restore that revision, upload the image again and update the article.
A file I expected is not in the Unused view
The file is attached to a record, or a page still uses it. Past revisions count as well. Open the file's page and check Where used.