Display images in Forms

A display image adds visual instructions or context inside a Form. It is a content item, so it does not collect an answer. Use an Upload field instead when the person filling the Form needs to attach an image.

Add a display image

You need edit access to the Form.

1. Open the Form from Library, then select the section where the image should appear.
2. Select Add field or content.
3. Under Content, select Display image.
4. Under Image, choose an image file and wait for the upload to finish.
5. Enter Alt text that describes the image's useful information or purpose.
6. Optionally add a Caption for text that should be visible below the image.
7. Select Done.

The image appears in the selected section. Use Preview to check it in the same order and layout that people see while filling the Form. Both a selected image and non-empty alt text are required before the Form can be filled.

Write useful alt text and captions

Alt text gives people who use a screen reader an equivalent description. Keep it specific to the Form's task. For example, describe the relevant part of a diagram instead of writing only "image" or repeating its filename.

A caption is optional and visible to everyone. Use it for supporting context, attribution, or instructions. Alt text is still required when a caption is present.

Edit or arrange the image

Select the image item or its Edit action to replace the file, alt text, or caption. Review the description after replacing an image so it still matches. The item menu also lets you duplicate or delete the image, move it up or down, or move it to another section.

Fix common problems

• The Form shows an image issue: Open the Form issues list, select the issue, then choose an image or add the missing alt text.
• The upload fails: Try the file again or choose another image. If CareMap reports that the workspace does not have enough storage, choose a smaller file or free storage before retrying.
• The image is unavailable in Preview or Fill: Edit the display image, upload a replacement, confirm its alt text and caption, then select Done.
• The wrong image was added: Select Cancel before saving, or edit the saved item and upload the correct image.