umbraco-file-upload-preview

Map uploaded files to MIME-type-specific preview components in Umbraco backoffice.

4|Updated Mar 6, 2026
One-click install
npx skills add https://github.com/albanistrefi/umbraco_CLI --skill umbraco-file-upload-preview-albanistrefi
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: umbraco-file-upload-preview
Source: https://github.com/albanistrefi/umbraco_CLI/tree/main/skills/property-editors/umbraco-file-upload-preview
Command: npx skills add https://github.com/albanistrefi/umbraco_CLI --skill umbraco-file-upload-preview-albanistrefi

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

File uploads in Umbraco can feel opaque when users upload different file types, because there is no clear visual confirmation of what the system will accept or how the file will be represented.

Core Features & Use Cases

  • Create MIME-type-based preview components: Render tailored UI for uploaded files (for example, icons for documents or thumbnails for images) based on the file’s MIME type.
  • Register previews via an extension manifest: Declare an alias, type, weight, and the MIME types the preview supports so Umbraco can discover and use it.
  • Keep the UI responsive and safe: Implement an element that uses the provided File input to generate a preview URL and cleans up resources when removed.

Quick Start

Ask the AI to generate an Umbraco backoffice fileUploadPreview manifest and a Lit-based preview element for your target MIME types, using the official foundation documentation as the source of truth.

Frequently Asked Questions about umbraco-file-upload-preview

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a file upload preview in the Umbraco backoffice based on MIME type?

Creating a file upload preview in Umbraco requires mapping uploaded files to MIME-type-specific rendering behavior using a custom extension manifest and a Lit-based preview element. You register the manifest with forMimeTypes and implement an element that renders the provided File input safely.

How does the Umbraco extension manifest handle file upload previews?

The Umbraco extension manifest discovers and registers file upload previews by declaring an alias, type, weight, and the specific MIME types the preview supports. This mapping allows Umbraco to render tailored UI for different uploaded file types in the backoffice.

Can I use Lit web components for Umbraco backoffice media upload previews?

Yes, Lit web components are used to implement the preview element for Umbraco media uploads. The element receives the uploaded File input, generates a preview URL, and cleans up resources when the component is removed to keep the backoffice UI responsive.

What is the best way to render different file types in an Umbraco upload preview?

The best way to render different file types in Umbraco is by creating MIME-type-based preview components. This approach allows you to render tailored UI, such as icons for documents or thumbnails for images, directly within the backoffice upload interface.

Do I need to follow official Umbraco documentation to implement file upload preview components?

Yes, implementing file upload preview components requires fetching and following the official Umbraco foundation documentation. This ensures the extension manifest and Lit element are defined correctly according to the platform's standards for rendering media uploads.

Why does my Umbraco file upload preview fail to render for specific MIME types?

A file upload preview fails to render in Umbraco if the extension manifest does not correctly declare the supported MIME types using forMimeTypes. The manifest must accurately map the alias, type, weight, and element import for Umbraco to discover the preview.