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(6mo ago)0113[1 PRs](https://github.com/daun/statamic-original-filename/pulls)MITPHPPHP ^8.2CI failing

Since Dec 16Pushed 4mo 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 1w ago

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

38

—

LowBetter than 83% of packages

Maintenance71

Regular maintenance activity

Popularity13

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity52

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

190d 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

71548.3k](/packages/statamic-seo-pro)[statamic-rad-pack/runway

Eloquently manage your database models in Statamic.

137236.2k8](/packages/statamic-rad-pack-runway)[rias/statamic-redirect

29347.4k](/packages/rias-statamic-redirect)[duncanmcclean/statamic-cargo

Comprehensive e-commerce addon for Statamic. Build bespoke e-commerce sites without the complexity.

3622.8k](/packages/duncanmcclean-statamic-cargo)[marcorieser/statamic-livewire

A Laravel Livewire integration for Statamic.

23122.2k16](/packages/marcorieser-statamic-livewire)[aerni/advanced-seo

Comprehensive SEO addon for Statamic with flexibility in mind

1818.9k](/packages/aerni-advanced-seo)

PHPackages © 2026

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