Features

Friendly Media extends Umbraco’s Media section with powerful tools that make it easier to manage large media libraries, maintain SEO-friendly URLs, and protect against data loss.

This page gives a feature-by-feature overview of what the package offers.

URL Management

Automatic Friendly URLs

Friendly Media automatically generates clean, SEO-friendly URLs for every media item. These URLs remove Umbraco’s hashed folder segment, resulting in simpler and more readable paths such as:

https://www.mysite.com/media/myimage.jpg

• Automatically applied to all uploaded media.
• Prevents duplicate URLs across the library.
• Automatically redirects if the underlying file changes.

Custom URLs

Each media item can have an additional custom URL defined by editors for better keyword control or campaign tracking.

https://www.mysite.com/media/biscuit-collection.jpg

Custom URLs remain stable even if the original file is replaced or renamed.

Dashboard Overview

Friendly Media introduces a dedicated dashboard within Umbraco’s Media section. The dashboard provides a central overview of all media URLs, along with search, filter, and bulk-management tools.

Key features include:

• Search and filter by filename, path, or URL.
• Quick visual feedback through helpful warning badges.
• Bulk actions for efficient library maintenance.
• CSV export for auditing or reporting.

Warning Badges

The dashboard displays at-a-glance badges to help identify potential issues before they cause broken links or SEO problems.

🔴 Missing File - The file is missing from disk or storage.

🟠 Duplicate URL - Another media item shares the same URL.

🟡 Filename Changed - The file has been renamed/replaced.

⚪ Unused Media - The item isn’t referenced anywhere in content.

Badges update automatically as content or media changes, ensuring you always have an up-to-date view of your library’s health.

Deletion Guard

Deletion Guard prevents accidental deletion of media items that are still in use. Before an item is deleted, Friendly Media checks for references using both Umbraco relations and UDI/URL scanning (configurable).

If a media item is found to be in use, the deletion is blocked and a warning is shown to the user.

Configuration options:

UseRelations: Checks Umbraco’s built-in relation data.

UseUdiExamine: Uses Examine to scan content for references.

Restore From Bin

Deletion Guard disabled and you've accidentally deleted some in-use media? The Restore From Bin feature allows editors to recover all media items which are in use directly from the Recycle Bin.

Retains friendly URLs and redirects.

Can restore to the original folder or a configured fallback parent.

CSV Export

Export a complete list of your media URLs — including friendly and custom URLs — for review or backup.

Use the Export CSV button at the bottom of the dashboard to generate a report that includes:

• Media name and type
• Auto and custom URLs
• File size and creation date
• Warning status (if applicable)

This is particularly useful for pre-launch audits or maintaining an external SEO reference list.

Content App Integration

Each media item includes a Friendly Media Content App tab for quick per-item management.

From here, editors can:

• View or edit custom URLs.
• See usage badges for that specific item.
• Reset or clear URLs without leaving the item view.

Safe File Streaming

When configured, Friendly Media can stream files directly through middleware to retain friendly URLs even when the underlying storage path changes.

⚠️ Important: If EnableStreaming is enabled, full size media files are served directly and bypass Umbraco’s ImageSharp processing and caching. Image transformations (e.g. ?width=400) will not be applied. Use this option only when you require direct file streaming and do not depend on Umbraco’s image pipeline.

Related Configuration

See the Getting Started → Configuration section for full details on all available settings, including DeletionGuard, RestoreFromBin, and EnableStreaming.