> ## Documentation Index
> Fetch the complete documentation index at: https://studio.bjanczak.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Configuration reference and feature matrix

> An inventory of shipped defaults, optional capabilities and the steps needed to enable them.

The package ships **344 configuration leaves** in `config/media-studio.php`, counting empty registration arrays as settings. The three references below cover each shipped leaf with its default and purpose. Environment variables can change those defaults. Credentials shown as `null` are intentionally unset, not a request to put secrets into source control.

| Reference | Settings covered |
| - | - |
| [Core configuration](https://studio.bjanczak.com/configuration-core.md) | Identity, workspaces, access, storage, encryption, mail, sharing, retention and navigation |
| [Processing and AI](https://studio.bjanczak.com/configuration-processing.md) | Images, PDF/Office/text thumbnails, video, audio, application-file thumbnails, extraction, OCR, semantic search and assistant |
| [Transfers and integrations](https://studio.bjanczak.com/configuration-integrations.md) | Upload sessions, S3 multipart, REST, MCP, browser extension, Slack and CDN delivery |

These tables document package configuration. Nested registration objects and public component APIs have separate contracts: use [Filament](https://studio.bjanczak.com/filament.md), [FLEX Fields](https://studio.bjanczak.com/flex-fields.md), [React SDK](https://studio.bjanczak.com/api/sdk.md), [image recipes](https://studio.bjanczak.com/image-rendition-presets.md), [external renditions](https://studio.bjanczak.com/external-renditions.md), [custom filters](https://studio.bjanczak.com/custom-library-filters.md) and the guide linked beside each configuration group.

## Optional capability matrix

Enabling a switch does not install an executable, grant an ability, start a worker or configure a cloud account. Match all requirements in the relevant guide.

| Capability | Shipped state | Enable and deploy |
| - | - | - |
| Native image conversions | Enabled; queue execution | Configure encoder and processing worker; [image recipes](https://studio.bjanczak.com/image-rendition-presets.md) |
| PDF first-page thumbnails | Disabled globally | Enable document thumbnails; Poppler or PDF-enabled libvips; [PDF guide](https://studio.bjanczak.com/document-thumbnails.md) |
| Office thumbnails | Not registered | Register MIME types and LibreOffice generator on an isolated worker; [Office guide](https://studio.bjanczak.com/document-thumbnails.md#office-documents) |
| TXT, Markdown, text-only HTML thumbnails | Disabled per MIME | Enable MIME mapping and local Unicode font; [text thumbnails](https://studio.bjanczak.com/document-thumbnails.md#text-markdown-and-text-only-html) |
| Video posters | Video processing disabled | Enable video processing and FFmpeg on an asynchronous connection; [video thumbnails](https://studio.bjanczak.com/video-thumbnails.md) |
| Compressed video playback | Disabled | Enable processing.video.compress and encoder; [video processing](https://studio.bjanczak.com/video-thumbnails.md) |
| Video trimming | Disabled | Independent video\_editing settings and worker; [trim videos](https://studio.bjanczak.com/video-editing.md) |
| Audio waveforms | Enabled | FFmpeg and audio-waveforms worker; [audio previews](https://studio.bjanczak.com/audio-previews.md) |
| Application-file thumbnails | Disabled | Enable application sources and bounded thumbnail cache; [application thumbnails](https://studio.bjanczak.com/application-files-thumbnails.md) |
| Image/video AI labels | Disabled | Enable media kinds, provider credentials and automatic admission if desired; [AI labels](https://studio.bjanczak.com/ai-image-labels.md) |
| Content extraction | Disabled | Enable extraction and worker; PDF and OCR have independent switches; [content indexing](https://studio.bjanczak.com/search-content-indexing.md) |
| Semantic search | Disabled | Supply an embedder and indexing lifecycle; [semantic search](https://studio.bjanczak.com/semantic-search.md) |
| Meilisearch | Disabled | Configure server, credentials and index lifecycle; [search](https://studio.bjanczak.com/search.md) |
| Conversational assistant | Disabled | Configure Laravel AI models and an asynchronous worker; [assistant](https://studio.bjanczak.com/assistant.md) |
| Resumable uploads | Disabled | Enable sessions and maintain staging/expiry; [resumable transfers](https://studio.bjanczak.com/upload-resumable.md) |
| Direct S3 multipart | Disabled | Enable sessions and multipart, private S3 and client direct mode; [S3 multipart](https://studio.bjanczak.com/upload-s3-multipart.md) |
| Browser extension | Disabled | Enable integration, pairing and scoped access; [extension setup](https://studio.bjanczak.com/browser-extension/install.md) |
| REST API | Disabled | Enable routes and issue scoped token; [REST API](https://studio.bjanczak.com/api/introduction.md) |
| MCP | Disabled | Configure connection/authentication, tools and permissions; [MCP access](https://studio.bjanczak.com/mcp-access.md) |
| Slack | Disabled | Optional integration migrations, OAuth and scheduled processing; [Slack](https://studio.bjanczak.com/slack.md) |
| CDN delivery | Disabled | Configure named adapters/profiles and authorization; [CDN delivery](https://studio.bjanczak.com/cdn-delivery.md) |
| Guest-upload links | Disabled | Enable link policy and bounds; [guest uploads](https://studio.bjanczak.com/guest-uploads.md) |
| Background ZIP archives | Disabled | Enable archive storage and worker; [archives](https://studio.bjanczak.com/archive-downloads.md) |
| Trash expiry | Disabled | Opt into retention days and maintenance; [trash lifecycle](https://studio.bjanczak.com/trash.md) |
| Web push | Disabled | Configure VAPID credentials and delivery; [notifications](https://studio.bjanczak.com/notifications.md) |
| Encryption | off policy | Select supported infrastructure/application policy and keys; [encryption](https://studio.bjanczak.com/encryption.md) |
| Standalone accounts | Disabled | Enable auth, optionally registration and configure mail; [accounts](https://studio.bjanczak.com/standalone-accounts.md) |
| Filament / FLEX Fields | Optional packages | Explicit adapter configuration; standalone Studio does not require either package |

## Additional runtime overrides

The current implementation also reads the following overrides, although the published default array does not declare them. They are documented separately so that this inventory does not silently omit them.

| Setting | Runtime fallback | Behavior |
| - | - | - |
| `processing.native.dispatch_retry_seconds` | `600` | Delay before redispatching eligible rendition work; minimum 30 seconds. Does not reset max\_attempts. |
| `assistant.attachment_directory` | `storage_path('app/private/media-studio-assistant')` | Private local staging area for assistant attachments; requires writable space and the attachment lifecycle's cleanup. |
| `upload.extensions` | Current browse extension list | Array restricting allowed extensions, intersected with browse choices and workspace restrictions; do not set null. See [accepted upload types](https://studio.bjanczak.com/uploads.md). |
| `browse.extensions` | Built-in category extensions | Overrides extension choices exposed by browse filtering; this does not grant permission to upload a disallowed type. |

## Apply configuration deliberately

Merge the example's keys into the matching section of the published configuration. A shortened example is not a replacement for the entire file. Keep credentials in environment/deployment secrets. After changing cached Laravel configuration, rebuild it and restart long-running workers so they receive the new settings:

```bash theme={null}
php artisan config:cache
php artisan queue:restart
```

Queued rendition recipes retain their admitted settings. Configuration changes alone do not regenerate existing media. Use [bounded backfill and reconciliation](https://studio.bjanczak.com/rendition-processing.md), and validate an output before expanding the batch. Cloud integrations, codecs and application resolvers require verification in your deployment; a documentation inventory is not an integration benchmark.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.