Media library

Overview

The media library (Admin → Media) stores images and files under public/uploads/. Assets are referenced by ID in entries, pages, richtext fields, and commerce digital products.

Uploading files

1. Open Media.
2. Choose a folder (optional).
3. Click Upload or drag files into the drop zone.
4. Wait for processing—compression and responsive variants generate when GD is available.

Using media in content

• Featured image — Picker on entry/page edit when the type supports it
• Richtext fields — Insert image button in the editor toolbar
• Media field type — Dedicated field on content types
• Block builder — Hero and image blocks reference media IDs

Folders and search

Organize assets into folders for large libraries. Search by filename or alt text from the media index.

Processing

With the gd extension enabled, Struxa compresses uploads and generates responsive image variants for faster storefronts. Without GD, originals are stored unchanged.

Permissions

Roles without manage_media may still select existing assets in pickers where editors allow it, but cannot upload new files.

Troubleshooting

• Upload fails — Check PHP upload_max_filesize and directory permissions on public/uploads/.
• Broken image on site — Confirm the file exists on disk; restores from backup may need uploads folder too.