Statamic v6 Support

This release requires Statamic v6. The Statamic v6 control panel ships with significant JavaScript and UI changes that are incompatible with earlier versions. v2.0 of Auto Alt Text is built for this new foundation — if you're on Statamic v5, use the v1.x branch instead.

Prism PHP Integration

Auto Alt Text now uses Prism PHP as its AI backend, replacing the built-in OpenAI and Moondream integrations. This gives you access to a wide range of AI providers through a single, unified configuration.

Supported Providers

Configure any Prism-supported provider via a single AUTO_ALT_TEXT_MODEL env variable:

• OpenAI (openai/gpt-4.1)
• Anthropic (anthropic/claude-sonnet-4-5)
• Ollama (ollama/llava)
• Mistral (mistral/pixtral-large-latest)
• And more — see Prism's documentation for the full list.

Breaking Changes

• Requires Statamic v6 — The v6 control panel JavaScript is incompatible with v5. There is no cross-version support.
• Moondream support removed — Prism does not support Moondream. Use Ollama with a vision model like llava for local processing.
• Configuration restructured — The nested services.openai.* config has been replaced with a flat model setting in provider/model format.
• Environment variables changed:
  • AUTO_ALT_TEXT_MODEL replaces AUTO_ALT_TEXT_SERVICE
  • OpenAI/provider API keys are now managed via Prism's own config (config/prism.php)
  • Removed: MOONDREAM_*, OPENAI_ENDPOINT, OPENAI_DETAIL

Migration Guide

Before (v0.x)

AUTO_ALT_TEXT_SERVICE#89DDFF;">=openai
OPENAI_API_KEY#89DDFF;">=sk-...
OPENAI_MODEL#89DDFF;">=gpt-4.1
OPENAI_ENDPOINT#89DDFF;">=https://api.openai.com/v1/chat/completions

After (v2.0)

AUTO_ALT_TEXT_MODEL#89DDFF;">=openai/gpt-4.1

API keys are configured in Prism's config (config/prism.php), which uses standard environment variables like OPENAI_API_KEY, ANTHROPIC_API_KEY, etc.

Re-publish the config to get the new structure:

php artisan vendor:publish --tag=statamic-auto-alt-text-config --force

Version Support

What's New

Statamic Auto Alt Text now uses Prism PHP as its AI backend, replacing the built-in OpenAI and Moondream integrations. This gives you access to a wide range of AI providers through a single, unified configuration.

Supported Providers

Configure any Prism-supported provider via a single AUTO_ALT_TEXT_MODEL env variable:

• OpenAI (openai/gpt-4.1)
• Anthropic (anthropic/claude-sonnet-4-5)
• Ollama (ollama/llava)
• Mistral (mistral/pixtral-large-latest)
• And more — see Prism's documentation for the full list.

Breaking Changes

• Moondream support removed — Prism does not support Moondream.
• Configuration restructured — The nested services.openai.* config has been replaced with a flat model setting in provider/model format.
• Environment variables changed:
  • AUTO_ALT_TEXT_MODEL replaces AUTO_ALT_TEXT_SERVICE
  • OpenAI/provider API keys are now managed via Prism's own config (config/prism.php)
  • Removed: MOONDREAM_*, OPENAI_ENDPOINT, OPENAI_DETAIL

Migration Guide

Before (v0.x)

AUTO_ALT_TEXT_SERVICE#89DDFF;">=openai
OPENAI_API_KEY#89DDFF;">=sk-...
OPENAI_MODEL#89DDFF;">=gpt-4.1
OPENAI_ENDPOINT#89DDFF;">=https://api.openai.com/v1/chat/completions

After (v1.0)

AUTO_ALT_TEXT_MODEL#89DDFF;">=openai/gpt-4.1

API keys are configured in Prism's config (config/prism.php), which uses standard environment variables like OPENAI_API_KEY, ANTHROPIC_API_KEY, etc.

Re-publish the config to get the new structure:

php artisan vendor:publish --tag=statamic-auto-alt-text-config --force

What's new

• Add comprehensive testing infrastructure with Pest 4
• Add GitHub Actions CI workflow for automated testing
• Add browser tests for UI interactions
• Add feature tests for asset event handling

What's fixed

• Remove parallel processing to improve reliability
• Save assets quietly to prevent premature alt text generation
• Improve OpenAI service parameter handling (which should have been included in v0.5.2)

Full Changelog: https://github.com/el-schneider/statamic-auto-alt-text/compare/v0.5.2...v0.5.3

What's new

• Add params config option to support reasoning models and enhance versatility

This release adds support for configurable parameters in OpenAI API calls, designed to work with reasoning models like OpenAI's o1 and gpt-5 series that require setting max_completion_tokens instead of max_tokens.

Full Changelog: https://github.com/el-schneider/statamic-auto-alt-text/compare/v0.5.1...v0.5.2

What's Changed

Bug Fixes

• Fixed issue with stale data when triggering job on asset with existing caption

Maintenance

• Updated gitignore configuration

Full Changelog: https://github.com/el-schneider/statamic-auto-alt-text/compare/v0.5.0...v0.5.1

What's new

• Antlers templating support for dynamic prompts with asset data
• Configurable system message to OpenAI service for better prompt control

Full Changelog: https://github.com/el-schneider/statamic-auto-alt-text/compare/v0.4.0...v0.5.0

What's new

• Individual asset ignore field for granular exclusion control
• Global asset exclusion patterns to filter assets by filename or path
• Container-specific filtering for targeted exclusion rules

Full Changelog: https://github.com/el-schneider/statamic-auto-alt-text/compare/v0.3.2...v0.4.0

What's new

• add ---dispatch-jobs flag to allow asynchronous processing of alt text generation

Full Changelog: https://github.com/el-schneider/statamic-auto-alt-text/compare/v0.3.1...v0.3.2

What's fixed

• fix wrong permission checks, #1

Full Changelog: https://github.com/el-schneider/statamic-auto-alt-text/compare/v0.3.0...v0.3.1

What's new

• breaking: Command is now nested under statamic namespace - use php please auto-alt:generate instead of php artisan auto-alt:generate
• improvement: OpenAI default model changed from gpt-4-turbo to gpt-4.1-mini for better efficiency
• new: Added support for OpenAI 'detail' parameter (low/high/auto) for vision API
• improvement: Increased default max image dimension from 1920px to 2048px
• improvement: Use base64 images with OpenAI for convenience and better reliability

Full Changelog: https://github.com/el-schneider/statamic-auto-alt-text/compare/v0.2.0...v0.3.0

Release Notes

What's new

• Simplified and improved configuration structure
• Caption sanitization
• Improved readme

Full Changelog: https://github.com/el-schneider/statamic-auto-alt-text/compare/v0.0.1...v0.1.0