1.9 SEO Plugin Integration — Yoast SEO and Rank Math
Overview
SmartDescribe Pro is designed to help WooCommerce store owners improve product image alt text using AI.
For stores using SEO plugins such as Yoast SEO or Rank Math, understanding how image alt text fits into the wider SEO setup is important.
SmartDescribe Pro provides integration features for these SEO plugins in supported versions. This guide explains the relationship between image alt text and SEO, what to check when using an SEO plugin, and how to avoid common configuration mistakes.
Important: SmartDescribe Pro focuses on image alt text. It does not replace your SEO plugin, perform every SEO task, or guarantee higher search rankings.
Understanding Image Alt Text and SEO
Alt text is a textual description associated with an image. It serves an important accessibility purpose by helping people who cannot see an image understand its relevant content.
Search engines can also use image alt text as one signal when interpreting an image.
Useful alt text should describe the image accurately and concisely. It should not simply repeat a product title or contain a list of search keywords.
For example, a description such as:
Purple and yellow mosaic mushroom garden ornament
is generally more informative than:
Garden ornament mushroom mosaic gift handmade garden decoration best gift.
The first example identifies the subject and useful visual details without unnecessary repetition.
What SmartDescribe Pro Does
SmartDescribe Pro uses AI to generate or improve image alt text for WooCommerce products.
Its primary purpose is to help you:
- Improve missing or unhelpful product image descriptions.
- Maintain more consistent alt text across your catalogue.
- Reduce repetitive manual editing.
- Tailor descriptions using available writing tones and category-specific templates.
- Manage optimisation through individual and bulk workflows.
SmartDescribe Pro targets the product’s featured image through its product optimisation workflow. Do not assume that it automatically updates every image in a product gallery.
Understanding Yoast SEO and Rank Math
Yoast SEO and Rank Math are WordPress SEO plugins that provide tools for managing different aspects of a website’s search optimisation.
They may help with areas such as page metadata, content analysis, structured data, and other SEO settings, depending on the plugin and installed features.
SmartDescribe Pro complements these tools by focusing on image alt text.
The purpose of the integration is to help the plugins work alongside your image optimisation workflow, not to replace their existing functionality.
Before You Begin
Before configuring an SEO integration:
- Install and activate SmartDescribe Pro.
- Confirm that WooCommerce is active.
- Configure and test your chosen AI provider.
- Install and activate Yoast SEO or Rank Math if you intend to use one.
- Confirm that your product images and alt text are being saved correctly.
- Review the integration settings available in your installed version of SmartDescribe Pro.
If you use more than one SEO plugin, review your configuration carefully. Running multiple SEO plugins that perform overlapping functions can create unnecessary duplication or conflicts.
Step 1: Check Your SEO Plugin
In WordPress, open your installed plugins list and confirm which SEO plugin is active.
You may be using:
- Yoast SEO.
- Rank Math.
- Another SEO plugin.
- No separate SEO plugin.
SmartDescribe Pro’s core purpose—optimising product image alt text—remains distinct from the broader SEO features provided by these tools.
Do not install an additional SEO plugin solely because you use SmartDescribe Pro. Choose an SEO setup that suits your website and avoid unnecessary duplication.
Step 2: Open SmartDescribe Pro Settings
- Log in to WordPress.
- Navigate to SmartDescribe → Settings.
- Locate any SEO integration options provided by your installed version.
- Review the available settings and instructions.
The exact labels and configuration options may differ between releases.
If you cannot find an integration setting, confirm that your installed version supports the integration and consult its release-specific documentation.
Step 3: Configure the Available Integration
If your version provides settings for Yoast SEO or Rank Math, follow the instructions shown on the settings screen.
Before saving any changes, check:
- Which SEO plugin the setting relates to.
- Whether the integration is enabled or disabled.
- Whether any additional configuration is required.
- Whether the plugin displays a confirmation message after saving.
Do not assume that selecting an SEO plugin automatically enables every integration feature, or that the integration changes all SEO metadata.
SmartDescribe Pro’s main task remains the generation and optimisation of product image alt text.
Step 4: Optimise a Product Image
After checking the integration settings, test the workflow on an individual product.
- Navigate to SmartDescribe → Products.
- Find a product whose featured image needs better alt text.
- Review the existing description, if one is present.
- Run individual optimisation.
- Review the generated description.
- Confirm that the result is accurate and appropriate.
- Verify that the alt text has been saved.
Starting with one product makes it easier to identify problems before running bulk optimisation.
Step 5: Verify the Saved Alt Text
Open the relevant product in WooCommerce and inspect its featured image.
Depending on your setup, you can check the saved alt text through the product editor or the WordPress Media Library.
Confirm that:
- The description matches the image.
- The text is concise and useful.
- The saved value reflects the intended change.
- The image being inspected is the correct one.
If the alt text is not updated, check the result reported by SmartDescribe Pro before investigating the SEO plugin.
Step 6: Check the Front End
Where appropriate, inspect the product page on the public-facing website.
You can use your browser’s developer tools to inspect the image element and check whether it has an alt attribute.
For example, an image might contain:
alt="Purple and yellow mosaic mushroom garden ornament"
This is an illustrative HTML example, not a required format for every image.
Check that the text is attached to the intended image and that the page is displaying the expected product content.
Remember that a product image may be displayed differently in product listings, gallery views, or other parts of the theme. The featured-image optimisation workflow should not be assumed to update every separate image instance or gallery image.
Step 7: Understand What the Integration Does Not Guarantee
Using SmartDescribe Pro with an SEO plugin does not automatically guarantee:
- Higher search engine rankings.
- Improved traffic or sales.
- Better rankings for every product image.
- Correct alt text for every image without review.
- Optimisation of every image in a product gallery.
- Automatic correction of product titles, descriptions, URLs, or metadata.
- Compatibility with every third-party plugin or custom WooCommerce theme.
Alt text is one component of accessible, well-structured website content. Search visibility depends on many factors, including the quality of the page, relevance to search queries, technical performance, competition, and search engine systems.
Recommended Workflow
For stores using SmartDescribe Pro with Yoast SEO or Rank Math:
- Maintain one clearly configured primary SEO plugin.
- Confirm that the SmartDescribe Pro integration settings are available and configured as intended.
- Test image optimisation on an individual product.
- Verify that the alt text is saved correctly.
- Check the public-facing product page where necessary.
- Review descriptions for accessibility, accuracy, and natural wording.
- Use bulk optimisation for larger groups only after testing.
- Continue reviewing product pages and other SEO elements through your normal SEO workflow.
Troubleshooting
SmartDescribe Pro does not display my SEO plugin
Confirm that the relevant SEO plugin is installed and active, and check whether your version of SmartDescribe Pro supports its integration.
The integration setting is missing
Check the documentation for your installed release. Do not assume that every version has identical integration controls.
The generated alt text does not appear on the product page
First, verify that optimisation succeeded and that the alt text was saved to the correct image. Then inspect the front-end image and investigate any caching, theme, or image-display issues.
Yoast SEO or Rank Math reports an SEO issue
Check the specific warning provided by your SEO plugin. A warning about page content, metadata, links, or other SEO factors may be unrelated to image alt text.
The image description contains too many keywords
Review your writing tone and category-specific template settings. Use natural, accurate language rather than trying to insert every possible search term.
I use another SEO plugin
You can still use SmartDescribe Pro for its core image alt text workflow, but do not assume that an integration is available for every SEO plugin. Check the supported integrations in your installed version.
Best Practices
- Prioritise accurate and useful image descriptions.
- Treat accessibility as a primary purpose of alt text.
- Avoid keyword stuffing.
- Keep your SEO configuration clear and avoid unnecessary plugin overlap.
- Test the integration before bulk processing.
- Verify that changes are saved to the intended image.
- Review the broader SEO health of product pages separately.
- Keep SmartDescribe Pro and your other plugins updated, using appropriate backups and testing procedures.
Summary
SmartDescribe Pro complements an SEO plugin by helping you create and manage product image alt text.
When used alongside Yoast SEO or Rank Math, it can form part of a broader WooCommerce optimisation workflow. The key is to configure the available integration correctly, verify that changes are saved, and review the quality of the resulting descriptions.
Good alt text should describe the image accurately and help people understand it. Any SEO benefit should follow from useful, relevant content—not from adding keywords for their own sake.
Next Guide
1.10 — Dashboard, Notifications and Monitoring
The next guide will cover the available monitoring tools and notifications in SmartDescribe Pro, including how to review optimisation activity and identify issues that need attention.