---
prompt: check-page-accessibility
title: Check a page for accessibility problems
description: Find missing alt text, skipped headings and vague links on a page, and fix them after you say yes.
category: Content
products: WordPress
mode: can make changes, asks first
tools: pages.list, pages.get, page-sections.list, page-sections.replace
url: https://jetpack.com/prompts/check-page-accessibility/
updated: 2026-10-25
---

# Check a page for accessibility problems

Find missing alt text, skipped headings and vague links on a page, and fix them after you say yes.

## Prompt

> Check my [Home] page for accessibility problems: images with no alt text, headings that skip a level, and links that just say “click here” or “read more”. List what you find in plain words, then ask before you fix anything.

Square brackets are placeholders. Ask the user to fill them in if they did not.

## Steps for your agent

1. Find the page with pages.list (search by title). Read it with pages.get (context "edit", content_format "raw") so you see every block, including ones inside groups and columns. Call page-sections.list with its id for the top-level sections.
2. Look for image blocks with an empty alt, headings that skip a level (an h2 then an h4), and link text like “click here”, “read more” or a bare URL.
3. List each problem with where it is and a suggested fix. Say when you can’t see an image well enough to describe it.
4. Ask before fixing. On yes, call page-sections.replace on the top-level section that holds each fix, with its expected_block_hash and user_confirmed true. Change only what was agreed and keep the rest of that section exactly as it was.

## Tools

- `pages.list` (reads only, through `wpcom-mcp-content-authoring`): Find the page by its title.
- `pages.get` (reads only, through `wpcom-mcp-content-authoring`): Read the whole page, blocks inside groups and columns included.
- `page-sections.list` (reads only, through `wpcom-mcp-content-authoring`): List the page’s sections, to fix one at a time.
- `page-sections.replace` (makes changes, through `wpcom-mcp-content-authoring`): Fix one section in place.

Run each tool through the WordPress.com MCP server tool named next to it, with `action: "execute"`, `operation` set to the tool name, `wpcom_site` and `params`. Set `user_confirmed: true` only after the user approves a change.

## Before you start

- Free. Works on any Jetpack site.
- You need a role that can edit pages, like Editor or Administrator.

## Safety

Shows each fix and asks first. It changes one section at a time, so the rest of the page stays the same.