How to add alt text to images in Framer, including CMS images
By Jake Marsh · Updated
To add alt text to images in Framer, select an image layer and type it in the Image section of the right panel. To find every image that's missing it, including images inside components and CMS image fields, open Sightwell, click Scan project and look under Accessibility. For canvas images, click Preview fix and type the text once. For a CMS collection, give a template such as {Title}, cover photo, check the preview for every item, and apply.
What counts as missing or weak
Sightwell reports three kinds of finding:
| Finding | What it catches |
|---|---|
| Images without alt text | Image layers and images passed into components with no alt text |
| CMS images without alt text | Image fields in a CMS collection, item by item |
| Alt text that doesn't describe the image | File names like IMG_2041.jpg, single words like "image" or "photo", and very long alt text |
Each finding names its WCAG 2.2 criterion, 1.1.1 Non-text Content.
Steps for images on the canvas
- Open Sightwell and click Scan project.
- Open Images without alt text in the Audit tab. Each entry names the page and the layer.
- Click Preview fix. A box asks to Describe what the image shows.
- Type the alt text and check the before and after.
- Apply. For an image passed into a component, the alt text goes on that instance's image property.
Steps for a CMS collection
- Scan, then open CMS images without alt text for the collection.
- Click Preview fix and type a template. Fields go in braces:
{Title},{Title}, cover photo, or{Name|lower} logo. - Read the preview. It lists each item's slug with the alt text it would get.
- Apply. Items that someone edited since the scan are skipped and listed.
- Undo last fix if the result isn't what you wanted.
Templates that work
| Collection | Template | Result for one item |
|---|---|---|
| Blog posts | {Title}, cover photo | "Spring menu launch, cover photo" |
| Team | {Name}, {Role} | "Ana Ruiz, Head of design" |
| Products | {Name} in {Color} | "Canvas tote in olive" |
| Case studies | {Client} logo | "Northwind logo" |
If a field in the template is empty for an item, the separator next to it is dropped, so you don't get "Ana Ruiz, " with a trailing comma. {Title|max:60} cuts long titles. Filters lower, upper and title change the case.
A template gives each item honest, specific alt text from facts you already wrote. Images that carry information a field doesn't describe, like a chart, still deserve a sentence typed by hand.
Decorative images
An image that's only decoration, like a background texture, is better with empty alt text, so screen readers skip it. Sightwell lists images without alt text as Review, not Fix, for that reason: you decide which ones carry information.
What it costs
Scanning is free. Each fix is one of the trial's 15 uses over 7 days, and a trial fix changes up to 25 images, with no card needed. After that Sightwell is $19 a month, $169 a year or $199 once per seat. Every plan is on the Sightwell page.
Sightwell
Find and fix SEO, accessibility and launch problems across your Framer site: alt text, headings, contrast, link text, titles and descriptions, CMS fields and staging links $19 a month or $169 a year per seat, or $199 once.
Questions
Does Sightwell write alt text for me?
No. Alt text comes from what you type or from your own CMS fields through a template. Whether it describes the image correctly is for a person to judge.
Where is alt text in Framer's CMS?
On each image field of an item. Sightwell writes it to that same field's alt text, so the CMS page shows it wherever the image appears.
Will the fix change images I've edited since the scan?
No. A change is skipped if the value changed since the scan, and the skipped items are listed.
Can I see every image's alt text at once?
The CSV from the Report tab lists every finding with where it is, which makes a handy checklist for a client review.
More Sightwell guides
- How to find and fix Framer page titles and meta descriptions
- Framer pre-launch checklist, and how to check it in one scan