How do I upload and organize images in VeloCMS?
Upload images by drag-and-drop or paste in the editor, manage them in the Media Library, and access previously uploaded files from any post without re-uploading.
To upload an image in VeloCMS, either drag and drop it directly onto the editor canvas, paste it from your clipboard, or use the /image slash command to open the file picker. Uploaded images are stored in Cloudflare R2 and accessible from any post through the Media Library — you never need to upload the same image twice.
How do I add an image in the middle of a post?
Place your cursor on a new line where you want the image to appear. Drag an image file from your desktop onto that spot in the editor — a blue insertion indicator shows exactly where it will land. Alternatively, press / to open the slash menu and choose Image or File Upload. A native file picker opens and you can select the image from your computer. Both methods upload the image to Cloudflare R2, generate responsive size variants, and insert a Next.js Image component in the post body. After the image appears in the editor, click on it to open the image options panel where you can add alt text, set the caption, or change the alignment.
Where is the Media Library and what can I do there?
The Media Library lives at Admin → Media. It shows a grid of every image (and other media file) you've ever uploaded to this blog, searchable by filename and filterable by file type (image, video, document) and upload date. From the library you can view any file's full URL (the R2 public CDN URL), copy the URL to use elsewhere, add or edit the alt text on an existing image, download the original file, or delete files you no longer need. Deleting a file from the library doesn't automatically remove it from posts — the image will show a broken link in posts where it was used, so check before deleting.
Can I insert a previously uploaded image into a new post?
Yes. Use the /image slash command and look for the From library tab in the image picker modal. It shows a grid of your recent uploads and lets you search by filename. Click any thumbnail and the image inserts at the cursor position. The post will reference the existing R2 URL rather than creating a duplicate copy — this keeps your storage usage down and ensures that updating the image in the Media Library (by replacing the file) propagates the change to every post that uses it.
How important is alt text and how do I add it?
Alt text is important for two reasons: accessibility (screen readers read it aloud to visually impaired users) and SEO (search engines index alt text to understand what the image shows). In VeloCMS, you add alt text by clicking on any image in the editor — the image properties panel slides in on the right with an Alt text field. Fill in a concise description of what the image shows (not what the image is called, but what it depicts). If you forget to add alt text before publishing, the SEO panel will flag the image as a missing alt text warning. The AI assistant can also suggest alt text — click the sparkle icon next to the alt text field and it generates a description from the image content.
VeloCMS automatically generates WebP versions of uploaded JPEG and PNG images and serves the optimal format to each visitor's browser. Modern browsers get WebP (typically 25-35% smaller than JPEG at equivalent quality); older browsers get the original format. This happens transparently via Cloudflare's image transformation pipeline without any action from you.