{"id":253516,"date":"2025-10-10T11:47:35","date_gmt":"2025-10-10T11:47:35","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/image-alt-sync\/"},"modified":"2025-10-10T11:48:54","modified_gmt":"2025-10-10T11:48:54","slug":"image-alt-sync","status":"publish","type":"plugin","link":"https:\/\/pcd.wordpress.org\/plugins\/image-alt-sync\/","author":14207762,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_crdt_document":"","version":"1.4.11","stable_tag":"1.4.11","tested":"6.8.5","requires":"5.4","requires_php":"","requires_plugins":null,"header_name":"Image Alt Sync","header_author":"Laurent DUFOUR","header_description":"Replace alt attributes in post content with the media library alt text. Batch processing with status\/date filters, post ID ranges, skip & exclude options, dry run logs (browser & WP-CLI).","assets_banners_color":"","last_updated":"2025-10-10 11:48:54","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"","header_author_uri":"https:\/\/www.laurentdufour.eu\/","rating":0,"author_block_rating":0,"active_installs":10,"downloads":237,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.4.11":{"tag":"1.4.11","author":"dufour_l","date":"2025-10-10 11:48:54"}},"upgrade_notice":{"1.3":"

Same sleek UI as 1.1 with all the newer capabilities from 1.2.<\/p>"},"ratings":[],"assets_icons":[],"assets_banners":[],"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.4.11"],"block_files":[],"assets_screenshots":[],"screenshots":[],"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[1953,17214,11137,163,186],"plugin_category":[34,50,55],"plugin_contributors":[165865],"plugin_business_model":[],"class_list":["post-253516","plugin","type-plugin","status-publish","hentry","plugin_tags-accessibility","plugin_tags-alt-text","plugin_tags-batch","plugin_tags-images","plugin_tags-seo","plugin_category-accessibility","plugin_category-media","plugin_category-seo-and-marketing","plugin_contributors-dufour_l","plugin_committers-dufour_l"],"banners":[],"icons":{"svg":false,"icon":"https:\/\/s.w.org\/plugins\/geopattern-icon\/image-alt-sync.svg","icon_2x":false,"generated":true},"screenshots":[],"raw_content":"\n

Image Alt Sync<\/strong> scans selected posts and updates any <img><\/code> tags found in the post content that reference media items (class wp-image-###<\/code>), and replaces their alt<\/code> attributes with the attachment\u2019s _wp_attachment_image_alt<\/code> value:\n- If the image is in the Media Library, it prefers the attachment\u2019s Alt Text.\n- If no attachment alt is set, it falls back to the image filename (without extension) or the post title (configurable in the UI).\n- Optionally skip images that aren\u2019t found in the Media Library.\n- Optionally restrict by image file extensions (e.g. jpg,webp<\/code>).<\/p>\n\n

Run in dry run<\/strong> first to see exactly what would change. The log shows each post processed and any per-image alt changes.<\/p>\n\n

Highlights<\/strong>\n- Processes per post<\/strong> in batches<\/strong> with a customizable delay<\/strong> (default 100 posts, 1s).\n- Filter by post status<\/strong> and date range<\/strong> (quick buttons: Today, Yesterday, Last week, Last month, YTD, All).\n- Validate<\/strong> that \u201cDate after\u201d \u2264 \u201cDate before\u201d.\n- Limit by Post ID range<\/strong> with buttons to auto-fill lowest<\/strong> and highest<\/strong> post IDs.\n- Skip posts without <img><\/code><\/strong> (optional).\n- Exclude image extensions<\/strong> (comma-separated, e.g. .svg,.gif<\/code>).\n- Dry run<\/strong> (browser & WP-CLI) shows clickable post IDs, post titles, filenames<\/strong>, and detailed old \u2192 new<\/strong> alt replacements.\n- Only processes posts that have at least one image attachment<\/strong>.<\/p>\n\n

For more details you can send mail with your suggestions, recommendation to dufour_l@hotmail.com<\/p>\n\n

Usage<\/h3>\n\n
    \n
  1. Choose your filters (date range, min\/max post ID, or \u201cApply to all posts\u201d).<\/li>\n
  2. Set Batch size<\/strong> and optional Delay<\/strong> between batches to throttle load.<\/li>\n
  3. Choose a Date Range<\/strong>, or click a shortcut button (autofills Date after<\/strong>\/Date before<\/strong>).<\/li>\n
  4. (Optional) Enter Lowest\/Highest Post ID<\/strong> or click the quick-fill buttons.<\/li>\n
  5. (Optional) Check Skip posts without <img><\/code><\/strong>.<\/li>\n
  6. (Optional) Enter Exclude extensions<\/strong> like .svg,.gif<\/code>.<\/li>\n
  7. Optionally enable Dry run<\/strong> to preview changes without saving.<\/li>\n
  8. Click Start<\/strong>. Progress and detailed per-post changes appear in the log.<\/li>\n
  9. If needed, click Stop<\/strong> to pause after the current batch finishes.<\/li>\n<\/ol>\n\n

    Tips<\/strong>\n- Use the \u201cLowest ID\u201d and \u201cHighest ID\u201d buttons to auto-fill the ID range.\n- Use the extension filter (e.g. jpg, jpeg, png, webp<\/code>) to target specific image types.\n- Check \u201cSkip images not in media library\u201d to avoid external or missing files.<\/p>\n\n

    Usage (WP-CLI)<\/h3>\n\n

    From your WordPress root:<\/p>\n\n

    wp image-alt-sync run --status=publish --after=2025-01-01 --before=2025-08-13 --batch-size=100 --delay=1 --dry-run --low-id=1 --high-id=9999 --skip-noimg=1 --exclude-ext=\".svg,.gif\"\n<\/code><\/pre>\n\n
    Args<\/strong>\n- --status=<\/code> publish|pending|draft|any (default: publish)\n- --after=<\/code> YYYY-MM-DD (optional)\n- --before=<\/code> YYYY-MM-DD (optional)\n- --batch-size=<\/code> integer (default: 100)\n- --delay=<\/code> seconds (float, default: 1)\n- --dry-run<\/code> flag (no changes saved if provided)\n- --low-id=<\/code> minimum post ID (optional)\n- --high-id=<\/code> maximum post ID (optional)\n- --skip-noimg=<\/code> 1|0 (default 0)\n- --exclude-ext=<\/code> comma-separated list like .svg,.gif<\/code><\/p>\n\n
    Credits<\/h3>\n\n
    Crafted with \u2764\ufe0f for accessible content.<\/p>\n\n\n
      \n
    1. Download the ZIP and install via Plugins \u2192 Add New \u2192 Upload Plugin<\/strong>.<\/li>\n
    2. Activate Image Alt Sync<\/strong>.<\/li>\n
    3. Go to Tools \u2192 Image Alt Sync<\/strong>.<\/li>\n<\/ol>\n\n\n
      \n
      Will it update the Media Library alt text?<\/h3><\/dt>\n
      No. This tool updates <img alt=\"\"><\/code> inside post content<\/strong>. It does not edit attachment fields.<\/p><\/dd>\n
      Does Dry Run modify anything?<\/h3><\/dt>\n
      No changes are saved during Dry Run. You\u2019ll only see a preview in the log.<\/p><\/dd>\n
      Which `` tags are updated?<\/h3><\/dt>\n
      Tags containing a class wp-image-###<\/code> so we can map to the attachment ID and read its media-library alt text.<\/p><\/dd>\n
      Does it also change the media alt in the library?<\/h3><\/dt>\n
      No\u2014this version focuses on replacing alt<\/code> inside post content from the media library value.<\/p><\/dd>\n
      What if an `` has no `alt`?<\/h3><\/dt>\n
      The plugin injects alt=\"...\"<\/code> based on the media alt.<\/p><\/dd>\n\n<\/dl>\n\n\n
      1.4.6 \/ 1.4.7 \/ 1.4.8 \/ 1.4.9 \/ 1.4.10 \/ 1.4.11<\/h4>\n\n
        \n
      • Fix: Code cleanup<\/li>\n<\/ul>\n\n
        1.4.5<\/h4>\n\n
          \n
        • Added two new date button ( last 4 weeks, since first of the month )<\/li>\n<\/ul>\n\n
          1.4.4<\/h4>\n\n
            \n
          • Fix: Code cleanup<\/li>\n<\/ul>\n\n
            1.4.2 \/ 1.4.3<\/h4>\n\n
              \n
            • Fix: Copyright sanitization.<\/li>\n<\/ul>\n\n
              1.4.1<\/h4>\n\n
                \n
              • Fix: Ajax not working.<\/li>\n
              • Add private to the post status<\/li>\n
              • Tested in Wordpress 6.8.2<\/li>\n<\/ul>\n\n
                1.4<\/h4>\n\n
                  \n
                • Fix: Eliminated [object Object]<\/code> messages by robust JSON\/error-string logging.<\/li>\n
                • Improvement: Processing now continues<\/strong> when a post\/batch fails; errors are reported in the log.<\/li>\n
                • Security: Added nonce checks to all AJAX endpoints.<\/li>\n
                • DX: Structured JavaScript in a separate file and passed ajaxurl<\/code>\/nonce<\/code> via wp_localize_script<\/code>.<\/li>\n
                • UI: Clearer batch progress messages and safer scrolling of the log.<\/li>\n<\/ul>\n\n
                  1.3<\/h4>\n\n
                    \n
                  • Restored the v1.1 UI while keeping the v1.2 functionality and enhancements.<\/li>\n
                  • Post ID range quick-fill buttons; dry run shows filenames and detailed changes.<\/li>\n
                  • Maintains batching, delay, status\/date filters, and WP-CLI parity.<\/li>\n<\/ul>\n\n
                    1.2<\/h4>\n\n
                      \n
                    • Replace alt<\/code> inside <img><\/code> tags using media alt; added ID ranges, skip & exclude options.<\/li>\n<\/ul>\n\n
                      1.1<\/h4>\n\n
                        \n
                      • Batch processing; status\/date filters; dry run logging; WP-CLI support.<\/li>\n<\/ul>","raw_excerpt":"Replace  tag alt attributes in posts with the alt stored in the media library. Batch processing, date\/status filters, ID ranges, skip & exclude op …","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/253516","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=253516"}],"author":[{"embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/dufour_l"}],"wp:attachment":[{"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=253516"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=253516"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=253516"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=253516"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=253516"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=253516"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}