PHPackages                             daun/statamic-original-filename - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. daun/statamic-original-filename

ActiveStatamic-addon[Utility & Helpers](/categories/utility)

daun/statamic-original-filename
===============================

Remember the original filenames of assets uploaded in Statamic

1.1.1(4mo ago)078[1 PRs](https://github.com/daun/statamic-original-filename/pulls)MITPHPPHP ^8.2CI failing

Since Dec 16Pushed 3mo agoCompare

[ Source](https://github.com/daun/statamic-original-filename)[ Packagist](https://packagist.org/packages/daun/statamic-original-filename)[ Docs](https://github.com/daun/statamic-original-filename)[ RSS](/packages/daun-statamic-original-filename/feed)WikiDiscussions main Synced today

READMEChangelog (4)Dependencies (8)Versions (6)Used By (0)

Statamic Original Filename
==========================

[](#statamic-original-filename)

**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
------------

[](#installation)

```
composer require daun/statamic-original-filename
```

Usage
-----

[](#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

[](#frontend)

To offer downloads using the original filename:

```
{{ asset }}

    Download {{ original_filename }}

{{ /asset }}
```

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

```
{{ asset }}

{{ /asset }}
```

### Backend

[](#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
-------

[](#license)

[MIT](https://opensource.org/licenses/MIT)

###  Health Score

39

—

LowBetter than 84% of packages

Maintenance78

Regular maintenance activity

Popularity11

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity51

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~18 days

Total

4

Last Release

145d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/31ac2b3787ded290b6bac87b937abf4f267483e4da64731bfb256a942bb669ca?d=identicon)[daun](/maintainers/daun)

---

Top Contributors

[![daun](https://avatars.githubusercontent.com/u/22225348?v=4)](https://github.com/daun "daun (18 commits)")

---

Tags

assetsstatamicstatamic-addonassetsstatamic

###  Code Quality

TestsPest

Static AnalysisPHPStan

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/daun-statamic-original-filename/health.svg)

```
[![Health](https://phpackages.com/badges/daun-statamic-original-filename/health.svg)](https://phpackages.com/packages/daun-statamic-original-filename)
```

###  Alternatives

[statamic/seo-pro

68516.6k](/packages/statamic-seo-pro)[marcorieser/statamic-livewire

A Laravel Livewire integration for Statamic.

23111.5k14](/packages/marcorieser-statamic-livewire)[withcandour/aardvark-seo

Save time and get your Statamic site to rank better with the SEO addon for Statamic.

15133.0k](/packages/withcandour-aardvark-seo)[aerni/livewire-forms

A Statamic forms framework powered by Laravel Livewire

2915.1k](/packages/aerni-livewire-forms)[mitydigital/feedamic

A fully-featured RSS and Atom feed generator for Statamic.

1075.6k](/packages/mitydigital-feedamic)[visuellverstehen/statamic-classify

A useful helper to add CSS classes to all HTML tags generated by the bard editor.

20121.3k](/packages/visuellverstehen-statamic-classify)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)