# Media library

The **Media** section is the site's library of images and files. Here you upload article covers, page images, documents.

## Uploading

1. Open **Media**.
2. Click "Upload" and select files (several at once is fine).
3. The files appear in the library and become available for insertion.

Uploaded files are stored in `storage/uploads/` and served via a direct link.

## Usage

- When creating an article/page, the image field opens a **picker from the media library** — select the file you need.
- To insert into text, copy the file's link from the library.

## Image size variants

For images the engine can serve scaled-down versions — this speeds up page loading. In templates these are filters:

```html
{image_url|thumb}    <!-- small preview -->
{image_url|medium}   <!-- medium size -->
{image_url|large}    <!-- large size -->
```

A content manager doesn't need to do anything — variants are chosen automatically wherever the theme uses them.

## Deleting

Delete only files you're sure aren't used: after deletion, links to them on the site will "break" (the image stops opening). Before deleting, make sure the file isn't attached to a published record.

## Recommendations

- Compress images before uploading (weight affects site speed and SEO).
- Use clear file names in latin letters.
- For covers, stick to a single aspect ratio — the feed will look tidy.
