Every image and file the client uploads goes to the media library, one place for the whole site. An image uploaded once serves any field — a post's cover, a gallery, the logo in the options, an image inside a text — without a second upload. Fields keep a reference to the file, not a copy, and every image field opens the same library, with its upload area, so the client picks an existing file or sends a new one from where they are.
What the library accepts
| Kind | Formats and maximum size |
|---|---|
| Images | JPG, PNG, GIF, WebP and SVG — 25 MB |
| Documents | PDF, Word (DOCX), Excel (XLSX), PowerPoint (PPTX) — 25 MB |
| Audio | MP3, M4A, OGG, WAV — 50 MB |
| Video | MP4, WebM, MOV — 200 MB |
| Compressed | ZIP — 100 MB |
Good to know when uploading
The hosting can set a lower upload limit than these; when it does, the upload area says so. Velk checks a file's actual content, not its name, so a file renamed to .jpg doesn't pass.
Names are cleaned on upload: Clinic Front 2.JPG becomes clinic-front-2.jpg, and a name already taken gets -1, -2 at the end. The name becomes part of the file's address, so a descriptive name before uploading beats IMG_4031.
Each image has its alt text in the library's detail panel: the short description screen readers read aloud and that shows when the image doesn't load. It is saved with the image, and the theme uses it wherever the image appears. On a multilingual site the panel has one alt per language.
Ask the AI
The case studies need a cover and a gallery. Make two sizes of the cover: one for the cards on the listing, 720×420 cropped to fit, and a wide one for the top of the case, 1440 wide. The gallery photos need one size for the grid. Use each image's alt text from the library.
Velk calls these sizes variants. Saying where each size shows lets the AI declare it on the right field.
Image sizes (variants)
A photo straight from a camera is far bigger than any spot on a page. Each image or gallery field can declare its own sizes, called variants — a card size, a banner size —, and the template asks for the one it needs. Velk generates them when the content is saved, never while a visitor waits. If a size is missing for some image, the site shows the original instead of a broken image.
- Fit inside (
contain): the whole image fits in the box. - Fill (
cover): the image covers the box; one side may go past it. - Cut to size (
crop): fills the box and trims the edges to the exact width and height.
No size ever enlarges an image past its original. Every photo also gets a small preview, which the admin uses.
Galleries and other files
A gallery field holds several images in the order the client drags them, with Add images to pick more from the library. For anything that isn't an image — a PDF menu, a price list, a video, a podcast episode — there is the file field: it takes any file from the library and can be limited to some kinds, like documents only.
Files a visitor sends through a form are a different thing: they never enter the library, stay private and are downloaded only from the form's screen in the admin.
Questions
Why won't my iPhone photo upload?
Photos saved as HEIC aren't among the accepted formats. Export them as JPG and upload again.
I declared a new size and older images don't have it.
Sizes are made when content is saved. For what was uploaded before, the AI runs media:variants. If sizes still don't appear, the server's PHP may lack its image extension (GD) — the AI can check.
Is the library the same in every language?
Yes: one library for the site. Only the alt text changes per language.