{"id":407230,"date":"2026-11-21T21:15:50","date_gmt":"2026-11-21T21:15:50","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/altsync-alt-text-everywhere\/"},"modified":"2026-11-21T21:15:17","modified_gmt":"2026-11-21T21:15:17","slug":"altrelay","status":"publish","type":"plugin","link":"https:\/\/wordpress.org\/plugins\/altrelay\/","author":23477791,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.0.0","stable_tag":"1.0.0","tested":"7.1.5","requires":"6.7","requires_php":"8.2","requires_plugins":null,"header_name":"AltRelay \u2013 Alt Text Everywhere","header_author":"codequelle.dev","header_description":"Change image alt text once and have it update everywhere on your site \u2014 automatically.","last_updated":"2026-11-21 21:15:17","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/codequelle.dev\/altrelay","header_author_uri":"https:\/\/codequelle.dev","rating":0,"author_block_rating":0,"active_installs":0,"downloads":40,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.0.0":{"tag":"1.0.0","author":"codequelle","date":"2026-11-21 21:15:17","revision":3815802}},"upgrade_notice":{"1.0.0":"<p>Initial release of AltRelay. Back up your database and review decorative images after activating.<\/p>"},"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3815802,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3815802,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3815802,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3815802,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{"blueprint.json":{"filename":"blueprint.json","revision":3815803,"resolution":false,"location":"assets","locale":"","contents":"{\"$schema\":\"https:\\\/\\\/playground.wordpress.net\\\/blueprint-schema.json\",\"landingPage\":\"\\\/wp-admin\\\/upload.php?page=altrelay\",\"preferredVersions\":{\"php\":\"8.3\",\"wp\":\"latest\"},\"login\":true,\"steps\":[{\"step\":\"installPlugin\",\"pluginData\":{\"resource\":\"wordpress.org\\\/plugins\",\"slug\":\"altrelay\"},\"options\":{\"activate\":true}},{\"step\":\"runPHP\",\"code\":\"<?php\\nrequire_once '\\\/wordpress\\\/wp-load.php';\\nrequire_once ABSPATH . 'wp-admin\\\/includes\\\/image.php';\\n\\n\\\/\\\/ Two demo images, drawn here so the preview needs no downloads.\\n$make = static function ( string $name, array $rgb, string $alt ): int {\\n\\t$upload = wp_upload_dir();\\n\\t$file   = trailingslashit( $upload['path'] ) . $name . '.png';\\n\\t$image  = imagecreatetruecolor( 1200, 800 );\\n\\n\\timagefill( $image, 0, 0, imagecolorallocate( $image, $rgb[0], $rgb[1], $rgb[2] ) );\\n\\timagefilledellipse( $image, 600, 400, 420, 420, imagecolorallocate( $image, 255, 255, 255 ) );\\n\\timagepng( $image, $file );\\n\\timagedestroy( $image );\\n\\n\\t$id = wp_insert_attachment(\\n\\t\\tarray(\\n\\t\\t\\t'post_mime_type' => 'image\\\/png',\\n\\t\\t\\t'post_title'     => ucfirst( $name ),\\n\\t\\t\\t'post_status'    => 'inherit',\\n\\t\\t),\\n\\t\\t$file\\n\\t);\\n\\n\\twp_update_attachment_metadata( $id, wp_generate_attachment_metadata( $id, $file ) );\\n\\n\\tif ( '' !== $alt ) {\\n\\t\\tupdate_post_meta( $id, '_wp_attachment_image_alt', $alt );\\n\\t}\\n\\n\\treturn $id;\\n};\\n\\n$described   = $make( 'lighthouse', array( 34, 113, 177 ), 'A white lighthouse against a blue sky' );\\n$undescribed = $make( 'harbour', array( 0, 124, 104 ), '' );\\n\\n$block = static function ( int $id ): string {\\n\\treturn sprintf(\\n\\t\\t\\\"<!-- wp:image {\\\\\\\"id\\\\\\\":%1\\\\$d,\\\\\\\"sizeSlug\\\\\\\":\\\\\\\"large\\\\\\\",\\\\\\\"linkDestination\\\\\\\":\\\\\\\"none\\\\\\\"} -->\\\\n<figure class=\\\\\\\"wp-block-image size-large\\\\\\\"><img src=\\\\\\\"%2\\\\$s\\\\\\\" alt=\\\\\\\"\\\\\\\" class=\\\\\\\"wp-image-%1\\\\$d\\\\\\\"\\\/><\\\/figure>\\\\n<!-- \\\/wp:image -->\\\",\\n\\t\\t$id,\\n\\t\\twp_get_attachment_image_url( $id, 'large' )\\n\\t);\\n};\\n\\nwp_insert_post(\\n\\tarray(\\n\\t\\t'post_title'   => 'A post with two images',\\n\\t\\t'post_status'  => 'publish',\\n\\t\\t'post_content' => \\\"<!-- wp:paragraph -->\\\\n<p>Both images were inserted without alt text. The first has a description in the Media Library, so AltRelay lists it under Media \\u2192 AltRelay, in Empty alt text in your content. The second has none yet: type one on the dashboard and it appears here.<\\\/p>\\\\n<!-- \\\/wp:paragraph -->\\\\n\\\\n\\\" . $block( $described ) . \\\"\\\\n\\\\n\\\" . $block( $undescribed ),\\n\\t)\\n);\\n\"}]}"}},"all_blocks":[],"tagged_versions":["1.0.0"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3815802,"resolution":"1","location":"assets","locale":"","width":2396,"height":2052},"screenshot-2.png":{"filename":"screenshot-2.png","revision":3815802,"resolution":"2","location":"assets","locale":"","width":2396,"height":1176},"screenshot-3.png":{"filename":"screenshot-3.png","revision":3815802,"resolution":"3","location":"assets","locale":"","width":2720,"height":1720}},"screenshots":{"1":"The AltRelay dashboard under Media: alt text coverage, the Review first switch, and inline editing for images that have no alt text yet.","2":"Empty alt text in your content, with Fill and Mark decorative per image or in bulk. The images marked decorative have a tab of their own.","3":"The Decorative image toggle in the block editor's settings sidebar."}},"plugin_section":[],"plugin_tags":[1953,17214,163,233,1558],"plugin_category":[34,50],"plugin_contributors":[294421],"plugin_business_model":[],"class_list":["post-407230","plugin","type-plugin","status-publish","hentry","plugin_tags-accessibility","plugin_tags-alt-text","plugin_tags-images","plugin_tags-media-library","plugin_tags-sync","plugin_category-accessibility","plugin_category-media","plugin_contributors-codequelle","plugin_committers-codequelle"],"banners":{"banner":"https:\/\/ps.w.org\/altrelay\/assets\/banner-772x250.png?rev=3815802","banner_2x":"https:\/\/ps.w.org\/altrelay\/assets\/banner-1544x500.png?rev=3815802","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/altrelay\/assets\/icon-128x128.png?rev=3815802","icon_2x":"https:\/\/ps.w.org\/altrelay\/assets\/icon-256x256.png?rev=3815802","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/altrelay\/assets\/screenshot-1.png?rev=3815802","caption":"The AltRelay dashboard under Media: alt text coverage, the Review first switch, and inline editing for images that have no alt text yet."},{"src":"https:\/\/ps.w.org\/altrelay\/assets\/screenshot-2.png?rev=3815802","caption":"Empty alt text in your content, with Fill and Mark decorative per image or in bulk. The images marked decorative have a tab of their own."},{"src":"https:\/\/ps.w.org\/altrelay\/assets\/screenshot-3.png?rev=3815802","caption":"The Decorative image toggle in the block editor's settings sidebar."}],"raw_content":"<!--section=description-->\n<p><strong>The problem AltRelay solves<\/strong><\/p>\n\n<p>When you add an image to WordPress, you give it a description (called \"alt text\") that helps screen readers and search engines understand what the image shows. WordPress stores this description in two separate places:<\/p>\n\n<ol>\n<li><strong>The Media Library<\/strong> \u2014 the central place where all your uploaded images live.<\/li>\n<li><strong>Each post or page<\/strong> \u2014 every time you insert an image, a copy of the alt text is saved inside that post's content.<\/li>\n<\/ol>\n\n<p>These two copies are independent. If you update the alt text in the Media Library, your posts keep the old version. If you fix it inside a post, the Media Library still has the original. And if an image had no alt text when you inserted it, every post keeps that empty copy, even after you describe the image later.<\/p>\n\n<p><strong>What AltRelay does<\/strong><\/p>\n\n<p>AltRelay connects these two places:<\/p>\n\n<ul>\n<li>Change alt text in the <strong>Media Library<\/strong> \u2192 every post using that image is updated in the background.<\/li>\n<li>Change alt text on an image in the <strong>block editor<\/strong> \u2192 when you save the post, the Media Library is updated, and from there every other post. The editor confirms it.<\/li>\n<li>A visitor views a page where an image has no alt text \u2192 AltRelay fills it in from the Media Library on the fly, without saving anything. This covers posts, pages, synced patterns, templates, block widgets and text widgets.<\/li>\n<\/ul>\n\n<p>There is nothing to configure. Activate the plugin and it works.<\/p>\n\n<p><strong>Decorative images<\/strong><\/p>\n\n<p>Some images only decorate and should be skipped by screen readers. Their alt text must stay empty. AltRelay never touches an image you mark as decorative:<\/p>\n\n<ul>\n<li>In the block editor on WordPress 7.1 or newer, tick WordPress's own <strong>Mark as decorative<\/strong> checkbox in the Image block settings. On older versions, and for Cover and Media &amp; Text blocks, AltRelay adds a <strong>Decorative image<\/strong> toggle to the block settings.<\/li>\n<li>Images hidden from screen readers in any other way (<code>role=\"none\"<\/code>, <code>role=\"presentation\"<\/code> or <code>aria-hidden=\"true\"<\/code>) are treated as decorative too.<\/li>\n<li>To make AltRelay leave every image in a section alone, give the block around them, for example a Group, the CSS class <code>altrelay-decorative<\/code> (Block settings \u2192 Advanced \u2192 Additional CSS class). AltRelay then fills and syncs none of their alt text, including in synced patterns inside the block. Images there that already have alt text keep it; empty them to make them silent.<\/li>\n<li>On the <strong>Media \u2192 AltRelay<\/strong> dashboard, the \"Empty alt text in your content\" list shows every image that has no alt text in a post but has one in the Media Library. Mark the decorative ones with one click, or fill the rest. The \"Images marked decorative\" list shows what is marked and lets you remove a mark again. Both lists can be narrowed to one content type.<\/li>\n<li>From the command line: <code>wp altrelay mark-decorative<\/code> and <code>wp altrelay unmark-decorative<\/code>.<\/li>\n<\/ul>\n\n<p>An image that is the only content of a link cannot be marked decorative. Its alt text is what names the link, so without it a screen reader user hears a link with no name. AltRelay refuses and says why; remove the link first, or give the image alt text.<\/p>\n\n<p>Why does marking matter? The block editor saves an empty alt for every image inserted without alt text, so an empty alt on its own almost always means \"not written yet\", not \"decorative\". AltRelay therefore fills unmarked empty alts. Leaving an informative image silent is the worse failure for a screen reader user, so the explicit mark is the safe default.<\/p>\n\n<p><strong>Review first<\/strong><\/p>\n\n<p>If your site already uses empty alt text on purpose, turn on <strong>Review first<\/strong> on the dashboard before anything is filled. While it is on, AltRelay leaves every existing empty alt alone: on your site, in the editor and when a description changes. Go through the review list, fill what should be described, mark what is decorative, then turn it off.<\/p>\n\n<p><strong>Who this plugin is for<\/strong><\/p>\n\n<ul>\n<li>Site owners who reuse images across multiple posts and want consistent alt text.<\/li>\n<li>Content teams who want alt text changes to take effect sitewide without editing every post manually.<\/li>\n<li>Anyone who wants every informative image on the site to have a description.<\/li>\n<\/ul>\n\n<p><strong>Who should NOT use this plugin<\/strong><\/p>\n\n<ul>\n<li>If you intentionally use <em>different<\/em> alt text for the same image depending on context (e.g. \"Team photo\" on one page, \"Our staff at the retreat\" on another) \u2014 AltRelay will overwrite those differences. It enforces one description per image, everywhere.<\/li>\n<li>If you need AI-generated alt text. AltRelay only syncs what you write \u2014 it does not create descriptions for you.<\/li>\n<\/ul>\n\n<p><strong>Important: read before activating<\/strong><\/p>\n\n<p>AltRelay changes the content of your posts when it syncs alt text. Please understand:<\/p>\n\n<ul>\n<li><strong>Back up your database first.<\/strong> This is your safety net if you want to undo everything at once.<\/li>\n<li><strong>Decide about decorative images first.<\/strong> After activating, open <strong>Media \u2192 AltRelay<\/strong>. Review the \"Empty alt text in your content\" list, or turn on <strong>Review first<\/strong> if there is a lot to go through.<\/li>\n<li><strong>One alt per image.<\/strong> If the same image has different alt text in different posts, AltRelay will replace them all with whatever you set next. The old per-post values are lost.<\/li>\n<li><strong>Nothing is saved on activation alone.<\/strong> AltRelay only writes to posts when alt text changes.<\/li>\n<li><strong>WordPress keeps revisions.<\/strong> Every post AltRelay updates goes through the normal WordPress save routine, so a new revision is created and you can restore any individual post from the post editor.<\/li>\n<li><strong>Synced posts get a new \"last modified\" date,<\/strong> like after any other edit. A developer can switch that off with the <code>altrelay_update_post_modified<\/code> filter.<\/li>\n<\/ul>\n\n<p><strong>How changes happen \u2014 a quick guide<\/strong><\/p>\n\n<h4>A visitor views a page<\/h4>\n\n<p>AltRelay fills in missing or empty alt text on the fly. Nothing is saved. Undo by deactivating the plugin.<\/p>\n\n<h4>You open a post in the editor<\/h4>\n\n<p>Empty alt text on images that are not marked decorative is filled from the Media Library, and the editor says how many images it filled. This does not count as a change: the post is not marked as edited, and nothing is written anywhere until you change something yourself and save. It works the same while the editor shows the template around the post.<\/p>\n\n<h4>You change alt text on an image block and save<\/h4>\n\n<p>The new value is sent to the Media Library, and from there to every post using that image. Discarding your edits sends nothing. Undo with post revisions or a backup.<\/p>\n\n<p>An autosave sends nothing, because the text may still be half typed. When a draft was only autosaved, its alt text is sent the next time you save the draft yourself, if the Media Library still has no description for that image. Alt text inside a template part or synced pattern is sent when that part or pattern is saved.<\/p>\n\n<h4>You clear alt text on an image block<\/h4>\n\n<p>Only that post changes. The Media Library keeps its description, and the editor offers to mark the image decorative.<\/p>\n\n<h4>You change alt text in the Media Library<\/h4>\n\n<p>Every post containing that image is updated in the background. A post that someone has open in the editor meanwhile keeps the new text when they save it. Undo with post revisions or a backup.<\/p>\n\n<h4>You clear alt text in the Media Library<\/h4>\n\n<p>The empty value is synced to all posts containing that image. When you describe the image again later, every post gets the new text.<\/p>\n\n<h4>You deactivate or delete AltRelay<\/h4>\n\n<p>Changes already made stay in the database, and so do decorative marks. Undo with a backup only.<\/p>\n\n<p><strong>Supported blocks:<\/strong> core\/image, core\/cover (including fixed and repeated backgrounds), core\/media-text, galleries, images inside synced patterns, and images in classic content.<\/p>\n\n<p><strong>Where AltRelay looks:<\/strong> posts, pages, custom post types, synced patterns, templates and template parts. Only posts that the person who made the change is allowed to edit are updated.<\/p>\n\n<p><strong>Syncing runs in the background.<\/strong> Changing alt text queues the work instead of doing it inside the request, and each run handles one batch of posts, so a site with thousands of posts never times out. Action Scheduler is used when it is available; otherwise WP-Cron. The dashboard shows updates that are still waiting, and any that failed. A post that cannot be saved does not stop the image's other posts; once the cause is fixed, an editor or administrator can try those images again from the dashboard. If WP-Cron does not run on your site, they can also run the waiting updates from there.<\/p>\n\n<p><strong>Posts someone cannot edit are left alone.<\/strong> When an author changes an image's description, posts by other people keep the old one. The dashboard says how many were skipped, and an editor or administrator can update them with one click.<\/p>\n\n<p><strong>What AltRelay does not cover<\/strong><\/p>\n\n<ul>\n<li><strong>Images it cannot tie to the Media Library.<\/strong> AltRelay recognises an image by the <code>wp-image-123<\/code> class WordPress gives it, and only when the image file really belongs to that Media Library item. A block copied from another website keeps that site's IDs; AltRelay leaves such images alone, and the editor tells you when it does. Replace the image from your own Media Library to connect it.<\/li>\n<li><strong>Content outside the post content.<\/strong> Page builders that keep their layout in custom fields, and image URLs stored in post meta or options, are not synced. Their output is not filled on the frontend either, unless the builder renders it through WordPress blocks. Developers can call <code>altrelay_fill_alt_text( $html )<\/code> on such output. Excerpts are not synced either: a WooCommerce product's short description keeps the alt text it was written with, while the product description is synced.<\/li>\n<li><strong>Markup that blocks from other plugins print themselves.<\/strong> Syncing works for any image in the post content. Filling on the frontend covers core blocks, including core Image blocks nested inside another plugin's block; an image that such a block outputs on its own is not filled unless a developer adds the block's name with the <code>altrelay_frontend_blocks<\/code> filter.<\/li>\n<li><strong>Block bindings and pattern overrides.<\/strong> When an image or its alt text comes from a binding, that source decides, and AltRelay leaves the block alone.<\/li>\n<li><strong>Featured images, galleries made with the <code>[gallery]<\/code> shortcode, and site logos<\/strong> always read their alt text straight from the Media Library, so they need no syncing.<\/li>\n<\/ul>\n\n<p><strong>Command line:<\/strong> on sites with WP-CLI, <code>wp altrelay<\/code> audits and repairs from the terminal: a coverage summary, a full repair with a dry run, the review lists, filling and marking in one post or wherever an image is used, the state of the queue, and running it. <code>wp help altrelay<\/code> lists every command and option. Run commands with <code>--user=&lt;login&gt;<\/code> to apply that user's editing permissions; a command that could not save a post exits with status 1.<\/p>\n\n<p><strong>For developers:<\/strong> filters, actions and functions let you change what is synced and how, or switch parts off. They are documented in the plugin's README, together with every WP-CLI command.<\/p>\n\n<p><strong>Privacy:<\/strong> AltRelay makes no external requests, uses no cookies, and collects no data. It stores a plugin version, the Review first switch, a welcome-notice flag, a few short-lived cache entries, the list of waiting background updates when WP-Cron runs them, on images marked decorative wherever they are used a note saying so, or how far the marking has got, and on a post that was open in the editor during an update, the alt text the update replaced, for a day. All of it is removed on uninstall.<\/p>\n\n<!--section=installation-->\n<ol>\n<li><strong>Back up your database.<\/strong> AltRelay modifies post content when syncing \u2014 a backup lets you fully undo any changes.<\/li>\n<li>Install AltRelay from <strong>Plugins \u2192 Add New Plugin<\/strong>, or upload the <code>altrelay<\/code> folder to <code>\/wp-content\/plugins\/<\/code>.<\/li>\n<li>Activate through the <strong>Plugins<\/strong> menu.<\/li>\n<li>Open <strong>Media \u2192 AltRelay<\/strong>. If your site uses empty alt text on purpose, turn on <strong>Review first<\/strong>. Mark any decorative images in the \"Empty alt text in your content\" list, and describe the images listed under \"Images without alt text in the Media Library\".<\/li>\n<\/ol>\n\n<p>No configuration needed.<\/p>\n\n<!--section=faq-->\n<dl>\n<dt id=\"should%20i%20back%20up%20before%20activating%3F\"><h3>Should I back up before activating?<\/h3><\/dt>\n<dd><p>Yes. AltRelay writes to post content when syncing alt text. A database backup is the safest way to undo bulk changes.<\/p><\/dd>\n<dt id=\"does%20anything%20happen%20right%20after%20activation%3F\"><h3>Does anything happen right after activation?<\/h3><\/dt>\n<dd><p>Nothing is saved. Visitors start seeing missing alt text filled in from the Media Library, and the dashboard lists what to review. If you would rather review before anything is filled, turn on Review first on the dashboard.<\/p><\/dd>\n<dt id=\"will%20altrelay%20overwrite%20alt%20text%20i%20already%20have%3F\"><h3>Will AltRelay overwrite alt text I already have?<\/h3><\/dt>\n<dd><p>When you change an image's alt text, the new value is written to <em>all<\/em> posts containing that image, except copies marked decorative. The frontend fallback never overwrites alt text that is already there.<\/p><\/dd>\n<dt id=\"how%20do%20i%20keep%20a%20decorative%20image%20silent%3F\"><h3>How do I keep a decorative image silent?<\/h3><\/dt>\n<dd><p>Mark it decorative: tick <strong>Mark as decorative<\/strong> in the Image block settings (WordPress 7.1+) or turn on AltRelay's <strong>Decorative image<\/strong> toggle (older versions, Cover and Media &amp; Text blocks), use <strong>Mark decorative<\/strong> on the dashboard, or run <code>wp altrelay mark-decorative<\/code>. Marked images are never filled or synced. If you later type a description into a block marked with AltRelay's toggle, the mark is removed and the description is synced like any other edit.<\/p><\/dd>\n<dt id=\"i%20emptied%20an%20image%27s%20alt%20text%20in%20the%20media%20library%20because%20it%20is%20decorative.%20why%20is%20it%20still%20listed%3F\"><h3>I emptied an image's alt text in the Media Library because it is decorative. Why is it still listed?<\/h3><\/dt>\n<dd><p>WordPress suggests leaving the Media Library alt text empty for a decorative image, but an empty field can also mean \"not described yet\", and AltRelay cannot tell which one you meant. Use <strong>Mark decorative<\/strong> next to the image in the \"Images without alt text in the Media Library\" list. AltRelay asks first, then marks the image decorative in every post that uses it, in the background like a sync, and the image leaves the list. If some uses cannot be marked (a post you may not edit, or an image that is the only content of a link and needs a description), the image stays listed and the dashboard says why. If the image is later added to a post without the mark, it is listed again, so the new copy can be marked too. <strong>List as missing again<\/strong> undoes it, and giving the image alt text later lists it with the described images.<\/p><\/dd>\n<dt id=\"i%20marked%20an%20image%20decorative%20by%20mistake.%20how%20do%20i%20undo%20it%3F\"><h3>I marked an image decorative by mistake. How do I undo it?<\/h3><\/dt>\n<dd><p>Open <strong>Media \u2192 AltRelay<\/strong> and use <strong>Remove decorative mark<\/strong> in the \"Images marked decorative\" list, or run <code>wp altrelay unmark-decorative<\/code>. The image gets its Media Library alt text back. In the editor, untick the checkbox or toggle.<\/p><\/dd>\n<dt id=\"why%20can%27t%20i%20mark%20a%20linked%20image%20as%20decorative%3F\"><h3>Why can't I mark a linked image as decorative?<\/h3><\/dt>\n<dd><p>When an image is the only thing inside a link, its alt text is the name of the link. Without it, a screen reader announces a link and nothing else. AltRelay refuses in the editor, on the dashboard and on the command line. Remove the link, add text to it, or give the image alt text.<\/p><\/dd>\n<dt id=\"i%20left%20alt%20text%20empty%20on%20purpose%20before%20installing%20altrelay.%20what%20happens%3F\"><h3>I left alt text empty on purpose before installing AltRelay. What happens?<\/h3><\/dt>\n<dd><p>Unmarked empty alts are treated as \"not written yet\", because that is what the block editor saves for images inserted without a description. Turn on <strong>Review first<\/strong> on the dashboard: AltRelay then leaves every empty alt alone while you go through the \"Empty alt text in your content\" list and mark the decorative ones. Turn it off when you are done.<\/p><\/dd>\n<dt id=\"i%20use%20different%20alt%20text%20for%20the%20same%20image%20in%20different%20posts.%20is%20that%20a%20problem%3F\"><h3>I use different alt text for the same image in different posts. Is that a problem?<\/h3><\/dt>\n<dd><p>Yes. AltRelay enforces one alt per image. If you rely on per-context alt text, this plugin is not for you.<\/p><\/dd>\n<dt id=\"can%20i%20undo%20changes%3F\"><h3>Can I undo changes?<\/h3><\/dt>\n<dd><p>Individual posts can be restored from WordPress revisions, because AltRelay saves through the normal WordPress post update routine. For a full rollback across many posts, you need a database backup taken before the change.<\/p><\/dd>\n<dt id=\"what%20happens%20if%20i%20clear%20alt%20text%3F\"><h3>What happens if I clear alt text?<\/h3><\/dt>\n<dd><p>In a post, only that post changes and the editor offers to mark the image decorative. In the Media Library, the empty value is synced to all posts using the image; describing the image again later updates them all.<\/p><\/dd>\n<dt id=\"does%20it%20work%20with%20the%20classic%20editor%3F\"><h3>Does it work with the Classic Editor?<\/h3><\/dt>\n<dd><p>Yes. The sync engine, the frontend fallback, the dashboard and WP-CLI work regardless of editor. The editor pull, push and decorative toggle are block editor features. In classic content, mark an image decorative from the dashboard or WP-CLI.<\/p><\/dd>\n<dt id=\"does%20it%20work%20with%20seo%2C%20image%20and%20alt%20text%20plugins%3F\"><h3>Does it work with SEO, image and alt text plugins?<\/h3><\/dt>\n<dd><p>Yes. Some SEO and alt text plugins fill empty alt text when a page is displayed: SEOPress does so by default, AltText.ai, Auto Alt Text, Rank Math and BIALTY when the option is switched on. They run after AltRelay and cannot see that an image was marked decorative, or that an image pasted from another site only carries the number of one of your Media Library items. AltRelay gives those images their empty alt back once every other plugin is done. Images AltRelay fills, and alt text an author wrote, are left to them. Image optimisers, lazy loading, caching, security, translation and media folder plugins need nothing.<\/p>\n\n<p>Only the alt text of what WordPress renders is checked. A plugin that changes the page after WordPress has finished it, in an output buffer, is not undone. In a template part such as the header, an image counts as decorative by its own setting, not by a decorative Group around it.<\/p><\/dd>\n<dt id=\"what%20if%20the%20plugin%20that%20brought%20action%20scheduler%20is%20deactivated%3F\"><h3>What if the plugin that brought Action Scheduler is deactivated?<\/h3><\/dt>\n<dd><p>Action Scheduler comes with plugins such as WooCommerce or an SEO plugin. When it goes away, the updates it was still holding for AltRelay are taken over by WP-Cron shortly after, or when the AltRelay dashboard is opened. On a network, a plugin deactivated for the whole network has this done on each of the first 100 sites; further sites take their updates over when their AltRelay dashboard is opened or <code>wp altrelay status<\/code> runs there.<\/p><\/dd>\n<dt id=\"does%20it%20work%20with%20page%20builders%3F\"><h3>Does it work with page builders?<\/h3><\/dt>\n<dd><p>It works wherever the builder saves normal image markup into the post content. Builders that keep their layout in custom fields are outside what AltRelay reads and writes. See \"What AltRelay does not cover\" above.<\/p><\/dd>\n<dt id=\"what%20happens%20when%20i%20deactivate%20or%20delete%20altrelay%3F\"><h3>What happens when I deactivate or delete AltRelay?<\/h3><\/dt>\n<dd><p>All changes to post content are permanent, including decorative marks. The frontend fallback stops immediately, and queued updates are cancelled. Deactivation and deletion do not modify any posts.<\/p><\/dd>\n<dt id=\"which%20wordpress%20versions%20are%20supported%3F\"><h3>Which WordPress versions are supported?<\/h3><\/dt>\n<dd><p>WordPress 6.7 or newer, on PHP 8.2 or newer. On WordPress 7.1 and newer, AltRelay uses the Image block's own <strong>Mark as decorative<\/strong> setting; on 6.7 to 7.0 it adds its own <strong>Decorative image<\/strong> toggle instead. Both are respected on every version, so nothing changes for images you already marked when you update WordPress.<\/p>\n\n<p>WordPress does not let you activate AltRelay on older versions. If it ends up active on one anyway, for example after moving a database to an older site, it stays inactive and shows administrators a notice until WordPress is updated.<\/p><\/dd>\n<dt id=\"does%20it%20work%20on%20multisite%3F\"><h3>Does it work on multisite?<\/h3><\/dt>\n<dd><p>AltRelay works per site: alt text changed while code is switched to another site of the network is synced on that site, if AltRelay is active there. A network-wide deactivation clears the queued work of every site. On multisite only Super Admins have the <code>unfiltered_html<\/code> capability. AltRelay saves the post's existing content without filtering it again, so a change made by another user never strips embeds or other markup from the rest of the post. Anything else that is saved during the same request is filtered as usual.<\/p><\/dd>\n<dt id=\"why%20did%20my%20alt%20text%20not%20change%20everywhere%3F\"><h3>Why did my alt text not change everywhere?<\/h3><\/dt>\n<dd><p>The usual reasons: the sync runs in the background, so give it a moment and check the dashboard, which also shows updates that failed. Posts the person who made the change cannot edit are skipped on purpose; the dashboard counts them and lets an editor or administrator update them. Images marked decorative are never changed. And an image whose file does not belong to the Media Library item named in its markup is left alone.<\/p><\/dd>\n<dt id=\"does%20altrelay%20change%20the%20rest%20of%20my%20post%20content%3F\"><h3>Does AltRelay change the rest of my post content?<\/h3><\/dt>\n<dd><p>No. It only rewrites the <code>alt<\/code> attribute of images that show the changed image, the matching label of a Cover background, and the Cover block's own alt setting. Embeds, forms and other markup are preserved, in the content and in the title and excerpt, also when the update runs in the background without a logged-in user.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.0.0<\/h4>\n\n<ul>\n<li>Initial release: alt text synced both ways between the Media Library and your content, a decorative mark that AltRelay respects everywhere, a dashboard to review what is empty or decorative, a frontend fallback, and WP-CLI commands.<\/li>\n<\/ul>","raw_excerpt":"Change image alt text once and have it update everywhere on your site \u2014 automatically.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/407230","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=407230"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/codequelle"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=407230"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=407230"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=407230"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=407230"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=407230"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=407230"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}