# Can't get {{item.image.caption}} to work

**URL:** <https://forums.realmacsoftware.com/t/cant-get-item-image-caption-to-work/51673>\
**Category:** Elements\
**Created:** [October 13, 2025, 7:59am UTC](https://forums.realmacsoftware.com/t/cant-get-item-image-caption-to-work/51673 "2025-10-13T07:59:19Z")\
**Posts on this page:** 10\
**Page:** 1

<div class="post-metadata">

**Author:** ![jbob](https://dub1.discourse-cdn.com/flex005/user_avatar/forums.realmacsoftware.com/jbob/32/31581_2.png) [@jbob](https://forums.realmacsoftware.com/u/jbob)\
**Post date:** [October 13, 2025, 7:59am UTC](https://forums.realmacsoftware.com/t/cant-get-item-image-caption-to-work/51673/1 "2025-10-13T07:59:19Z")

</div>

Can’t get {{item.image.caption}} to work

… I can call {{item.image.alt}} to work as a caption in the meantime

But wondering why it won’t call the caption … am I missing magic syntax ?

Have tried caption with and without “"

 ![image](https://europe1.discourse-cdn.com/flex005/uploads/realmacsoftware1/original/3X/7/0/70e986342fab773ab6c71ea672620883429f05e3.png)

---

<div class="post-metadata">

**Author:** ![dan](https://dub1.discourse-cdn.com/flex005/user_avatar/forums.realmacsoftware.com/dan/32/28516_2.png) [@dan](https://forums.realmacsoftware.com/u/dan)\
**Post date:** [October 13, 2025, 8:36am UTC](https://forums.realmacsoftware.com/t/cant-get-item-image-caption-to-work/51673/2 "2025-10-13T08:36:29Z")

</div>

The issue is most likely that Elements CMS doesn’t currently map nested keys (like item.image.caption). We’d have to manually add support for “caption” inside of an image. I’d need @ben to confirm this.

However, we do also support the title key on an image, so maybe a combination of title and alt will work for you?

```auto
image:
  src: blog/welcome.jpg
  title: "Title of my image"
  alt: "Alt text for my image"

```

---

<div class="post-metadata">

**Author:** ![jbob](https://dub1.discourse-cdn.com/flex005/user_avatar/forums.realmacsoftware.com/jbob/32/31581_2.png) [@jbob](https://forums.realmacsoftware.com/u/jbob)\
**Post date:** [October 13, 2025, 8:47am UTC](https://forums.realmacsoftware.com/t/cant-get-item-image-caption-to-work/51673/3 "2025-10-13T08:47:42Z")

</div>

Caption is mentioned in the manual

Thank you for your input - will try to use title for caption - think that’s what you’re suggesting

 ![image](https://europe1.discourse-cdn.com/flex005/uploads/realmacsoftware1/original/3X/5/8/585be2621293507750df72831464703250bf8fab.png)

---

<div class="post-metadata">

**Author:** ![jbob](https://dub1.discourse-cdn.com/flex005/user_avatar/forums.realmacsoftware.com/jbob/32/31581_2.png) [@jbob](https://forums.realmacsoftware.com/u/jbob)\
**Post date:** [October 13, 2025, 8:53am UTC](https://forums.realmacsoftware.com/t/cant-get-item-image-caption-to-work/51673/4 "2025-10-13T08:53:04Z")

</div>

Using title for caption works for me !!

 ![image](https://europe1.discourse-cdn.com/flex005/uploads/realmacsoftware1/original/3X/1/c/1cef78cfa555e5638587c5ecbf194704f0784e24.png)

---

<div class="post-metadata">

**Author:** ![dan](https://dub1.discourse-cdn.com/flex005/user_avatar/forums.realmacsoftware.com/dan/32/28516_2.png) [@dan](https://forums.realmacsoftware.com/u/dan)\
**Post date:** [October 13, 2025, 9:04am UTC](https://forums.realmacsoftware.com/t/cant-get-item-image-caption-to-work/51673/5 "2025-10-13T09:04:53Z")

</div>

Glad that’s working for you!

We have updated the manual, you can learn more about using images in front matter here:

> **[Frontmatter | RapidWeaver Elements Docs](https://docs.realmacsoftware.com/elements-docs/cms/cms/markdown/frontmatter#image-front-matter)**

---

<div class="post-metadata">

**Author:** ![jbob](https://dub1.discourse-cdn.com/flex005/user_avatar/forums.realmacsoftware.com/jbob/32/31581_2.png) [@jbob](https://forums.realmacsoftware.com/u/jbob)\
**Post date:** [October 13, 2025, 9:08am UTC](https://forums.realmacsoftware.com/t/cant-get-item-image-caption-to-work/51673/6 "2025-10-13T09:08:17Z")

</div>

Great - but controlling image sizes within markup is a bigger issue

---

<div class="post-metadata">

**Author:** ![Ulrich](https://dub1.discourse-cdn.com/flex005/user_avatar/forums.realmacsoftware.com/ulrich/32/29764_2.png) [@Ulrich](https://forums.realmacsoftware.com/u/Ulrich)\
**Post date:** [October 13, 2025, 10:48am UTC](https://forums.realmacsoftware.com/t/cant-get-item-image-caption-to-work/51673/7 "2025-10-13T10:48:03Z")

</div>

If you want to put the image with the markup language text you can use  
`<img src="/resources/imagename.jpg" alt="Alt Text" width="50%">`

or add

```auto
style="float:right;width:16rem;max-width:40vw;margin:0 0 0.5rem 1rem;border-radius:12px;box-shadow:0 10px 15px -3px rgba(0,0,0,.1),0 4px 6px -2px rgba(0,0,0,.05);object-fit:cover;"

```

---

<div class="post-metadata">

**Author:** ![Ulrich](https://dub1.discourse-cdn.com/flex005/user_avatar/forums.realmacsoftware.com/ulrich/32/29764_2.png) [@Ulrich](https://forums.realmacsoftware.com/u/Ulrich)\
**Post date:** [October 13, 2025, 11:07am UTC](https://forums.realmacsoftware.com/t/cant-get-item-image-caption-to-work/51673/8 "2025-10-13T11:07:31Z")

</div>

Example: [Artikel | CORNROW](https://www.cornrow.de/artikel/curly_treffen_in_s_ddeutschland)

use to see what i have done:  
`view-source:www.cornrow.de/artikel/curly_treffen_in_s_ddeutschland`

Line 718ff

---

<div class="post-metadata">

**Author:** ![jbob](https://dub1.discourse-cdn.com/flex005/user_avatar/forums.realmacsoftware.com/jbob/32/31581_2.png) [@jbob](https://forums.realmacsoftware.com/u/jbob)\
**Post date:** [October 13, 2025, 11:10am UTC](https://forums.realmacsoftware.com/t/cant-get-item-image-caption-to-work/51673/9 "2025-10-13T11:10:17Z")

</div>

You’ve given that dog a wooden leg !

---

<div class="post-metadata">

**Author:** ![Ulrich](https://dub1.discourse-cdn.com/flex005/user_avatar/forums.realmacsoftware.com/ulrich/32/29764_2.png) [@Ulrich](https://forums.realmacsoftware.com/u/Ulrich)\
**Post date:** [October 13, 2025, 12:10pm UTC](https://forums.realmacsoftware.com/t/cant-get-item-image-caption-to-work/51673/10 "2025-10-13T12:10:24Z")

</div>

Yes, that happened on the last ocean crossing. He saw a whale and wanted to retrieve it.
