Asset Metadata Importer

First stable release of the Statamic Asset Metadata Importer addon! 🎉🎉🎉

Say goodbye to manual metadata entry and hello to automated asset management. This addon automatically extracts embedded EXIF/IPTC metadata from your images and intelligently maps it to your Statamic asset fields.

✨ Core Features

Automatic Metadata Extraction

• Upload & forget - Automatically processes metadata on asset upload and re-upload
• Smart field mapping - Map any asset field to single or multiple metadata sources with intelligent fallback support
• Multibyte character support - Properly handles international characters (accents, non-Latin scripts, emoji, etc.)
• Overwrite control - Choose whether to preserve or update existing metadata on re-upload

Flexible Configuration

• Loose mapping mode - Enable partial matching for flexible metadata extraction without knowing exact tag names
• Configurable file types - Choose which file extensions should be processed
• Multiple metadata sources - Define fallback sources for each field (tries each in order)
• Debug mode - Detailed logging for troubleshooting and development

Performance & Compatibility

• Queue support - Process metadata imports asynchronously for better performance on large uploads
• Local and cloud storage - Works seamlessly with both local filesystems and remote storage (S3, etc.)
• Native PHP EXIF - Works out-of-the-box with JPG/TIFF using PHP's native functions
• Exiftool integration - Optional support for PNG, WEBP, AVIF and many more formats beyond basic JPEG/TIFF

🎯 Perfect For

This addon is ideal for:

• Photographers - Preserve Lightroom/Photoshop metadata in your Statamic assets
• Content creators - Automatically populate alt text and descriptions for SEO and accessibility
• Media professionals - Maintain copyright, credits, and attribution automatically
• Digital asset managers - Ensure consistency across large asset libraries
• Agencies - Save time on client projects by eliminating manual metadata entry

💡 Real-World Example

A photographer exports 100 images from Lightroom with embedded metadata (title, description, copyright, keywords). They upload them to Statamic, and this addon automatically:

1. Extracts the embedded metadata from each image
2. Maps title → alt field (for SEO and accessibility)
3. Maps copyright → copyright field
4. Maps credit → credit field
5. Maps description → description field

All 100 images are fully documented without a single manual entry. That's the power of metadata automation!

📦 Installation

Install via Composer:

composer require balotias/statamic-asset-metadata-importer

Publish the configuration file:

php artisan vendor:publish --tag=statamic-asset-metadata-importer-config

Optional: Extended Format Support

For PNG, WEBP, AVIF and enhanced metadata extraction, install Exiftool:

macOS:

brew install exiftool

Linux (Debian/Ubuntu):

apt-get install libimage-exiftool-perl

Then configure the path in your .env:

ASSET_METADATA_IMPORTER_EXIFTOOL_PATH#89DDFF;">=/usr/local/bin/exiftool

⚙️ Quick Setup

1. Configure your field mappings in config/statamic/asset-metadata-importer.php:

#89DDFF;">'fields#89DDFF;">' #89DDFF;">=> #89DDFF;">[
    #89DDFF;">'alt#89DDFF;">' #89DDFF;">=> #89DDFF;">'title#89DDFF;">'#89DDFF;">,
    #89DDFF;">'copyright#89DDFF;">' #89DDFF;">=> #89DDFF;">[#89DDFF;">'copyright#89DDFF;">'#89DDFF;">, #89DDFF;">'XMP-photoshop:Copyright#89DDFF;">'#89DDFF;">],
    #89DDFF;">'credit#89DDFF;">' #89DDFF;">=> #89DDFF;">[#89DDFF;">'credit#89DDFF;">'#89DDFF;">, #89DDFF;">'XMP-photoshop:Credit#89DDFF;">'#89DDFF;">],
#89DDFF;">],

2. Ensure your asset blueprint includes the fields you want to populate

3. Upload images - metadata is automatically extracted and mapped!

📚 Documentation

Full documentation with advanced configuration options, troubleshooting, and examples available in the README.

🧪 Quality Assurance

• 50 comprehensive tests covering all features, edge cases, and error scenarios
• 100% passing test suite
• Tested with Statamic 5.x and PHP 8.1+
• Production-ready and actively maintained

🛠️ Technical Details

• Requirements: Statamic 5.0+, PHP 8.1+
• Dependencies: miljar/php-exif, spatie/temporary-directory
• License: MIT
• Namespace: Balotias\StatamicAssetMetadataImporter

🙏 Acknowledgments

• Inspired by Image Metadata Importer
• Powered by the excellent miljar/php-exif library

---

Ready to automate your asset metadata? Install now and start saving time! 🚀

⚡ Requirements

Statamic 5.0+ PHP 8.1+ Optional: Exiftool binary for extended formats & tags support