On this page
Media

Where media lands in your repository

When media publishes, Acrosite commits it to the content type's media folder (public/images/<type-key> by default) and references it from your Markdown as a clean image path.

ReferenceFor DevelopersUpdated June 7, 2026

When media publishes, Acrosite commits it to a predictable place in your repository and references it from your Markdown with a clean path. This reference shows where images land and how they are referenced, so your site can serve them.

Who this is for

Developers connecting a site to Acrosite, and anyone curious where published images go.

Where media is committed

By default Acrosite writes media under public/images, with a folder per content type:

Paths
public/images               # project media root
public/images/posts         # Post images
public/images/pages         # Page images
public/images/<type-key>    # images for a Custom Content Type

Keeping media under public/images means image URLs stay clean and predictable. To use a different folder, change the content type's Media Folder and Media URL in its Repository Output settings; images uploaded afterwards use them, and earlier images keep their folder. See Acrosite-managed content paths.

How images are referenced

In the generated Markdown, an image is referenced by a web path that drops the public prefix, because most frameworks serve the public folder at the site root:

Markdown
![Alt text](/images/posts/my-image.webp "Optional title")

So a file committed at public/images/posts/my-image.webp is referenced as /images/posts/my-image.webp. See Generated Markdown and frontmatter for how this fits into the published file.

Make your site serve the media

Build your site to serve images from public/images (or map that location during your build). If you use a framework that serves a public directory at the web root, the /images/... references will resolve with no extra work.

Developer note
For a media folder outside public/ or static/, enter the URL your site serves it at, so the generated Markdown references images correctly.

Next steps