daun/statamic-original-filename

Remember the original filenames of assets uploaded in Statamic

1.1.0 2025-12-19 10:33 UTC

Requires

• php: ^8.2
• statamic/cms: ^5.70 || ^6.0@alpha

Requires (Dev)

• larastan/larastan: ^2.9 || ^3.0
• laravel/pint: ^1.14
• mockery/mockery: ^1.6
• orchestra/testbench: ^8.0 || ^9.0 || ^10.0
• pestphp/pest: ^2.0 || ^3.3
• pestphp/pest-plugin-laravel: ^3.0
• spatie/ray: ^1.42

MIT

• Philipp Daun

• assets
• statamic

README

Remember the original, unsanitized filenames of assets uploaded in Statamic.

This addon stores the original filename of uploaded assets in their metadata, allowing later access even after Statamic has sanitized the filename for compatibility. Useful for allowing downloads with the original name or using it as a worst-case alt text for images.

• Filename as uploaded: Fauvette à tête noire © Jean Dupont.jpg
• Filename as sanitized: fauvette-a-tete-noire-jean-dupont.jpg
• Original filename: Fauvette à tête noire © Jean Dupont

Installation

composer require daun/statamic-original-filename

Usage

Once installed, the addon will store the original filename of each uploaded asset in its metadata under the key original_filename. The filename is saved without the file extension.

Frontend

To offer downloads using the original filename:

{{ asset }}
  <a href="{{ url }}" download="{{ original_filename }}.{{ extension }}">
    Download {{ original_filename }}
  </a>
{{ /asset }}

To use the original filename as fallback alt text for images:

{{ asset }}
  <img src="{{ url }}" alt="{{ alt ?? original_filename }}">
{{ /asset }}

Backend

If you want your editors to see (and possibly edit) the original filename in the control panel, add a text field to your asset blueprint, using original_filename as the handle.

title: Asset
fields:
  -
    handle: alt
    field:
      type: text
      display: Alt Text
+  -
+    handle: original_filename
+    field:
+      type: text
+      display: Original Filename

License

MIT