Docs/Writing

Images and media

Add optimized images, alt text, tables, and embeds without leaving the editor.

Good posts are more than text. Blog CMS makes it easy to add images, tables, and embeds — and it handles the heavy lifting like optimization for you.

Adding images

There are three ways to add an image, and all of them work right in the editor:

  • Drag a file from your desktop into the post.
  • Drop multiple files at once to add them in sequence.
  • Paste an image straight from your clipboard (perfect for screenshots).

Once added, the image uploads and is optimized automatically so your pages stay fast. You don't need to resize or compress anything beforehand.

Alt text matters

Every image should have alt text — a short description of what it shows. Blog CMS lets you set it directly on each image. Alt text:

  • Helps readers using screen readers.
  • Gives search engines context, which supports your SEO.
  • Acts as a fallback if an image ever fails to load.

Make it a habit to fill this in as you write. SEO essentials explains why this adds up over time.

Tables

Use tables for anything structured — comparisons, specs, pricing, or feature grids. Add a table from the editor and fill in cells directly. Tables render cleanly in your published theme and stay readable on small screens.

Embeds

Embed external media such as videos and other supported content by adding an embed block. The embed appears inline in your post and renders properly once deployed.

Code and snippets

For technical writing, use inline code for short references and code blocks for longer examples. Code blocks come with syntax highlighting. If you write in Markdown, this is all handled with familiar fenced-code syntax — see Markdown.

Keeping pages fast

Because images are optimized on upload and pages ship as static HTML, your blog stays quick even with lots of media. A few good habits help:

  • Prefer one strong hero image over many decorative ones.
  • Always add alt text.
  • Use embeds for video rather than uploading large files.

OG images

You don't need to design a separate share image for each post — Blog CMS generates an OG image automatically. You can pick the template from your settings; see SEO essentials and Themes for how to control the look.

Questions about media handling? Email [email protected].