---
title: "Images"
description: "Keep images next to the content that uses them."
url: "https://www.andromedacms.dev/docs/images"
updated_at: 2026-09-24
---

# Images

## Next to the entry

```
app/content/posts/my-post/
├── index.md
└── cover.png
```

```markdown
![Cover](./cover.png)
```

Referenced images are copied into `app/assets/builds/andromeda/` during the
build and served, digest-stamped, by Propshaft.

## From the frontmatter

```yaml
---
title: My post
hero_image: ./cover.png
---
```

```ruby
attribute :hero_image, :image
```

```erb
<%= image_tag andromeda_image_url(@entry.hero_image) %>
```

A missing file, or a path that leaves the project, fails the build.

## Images you already have

| Written as | Result |
|------------|--------|
| `logo.png` (in `app/assets/images/`) | resolved through the asset pipeline, digest-stamped |
| `/banner.png` (in `public/`) | left as written |
| `https://example.com/x.png` | left as written |