SmartDescribe Pro Frequently Asked Questions and Best Practices | WooCommerce Plugins & Enhancements

Guide 1.11 — Frequently Asked Questions and Best Practices

Product: SmartDescribe Pro
Publisher: Cazgrae
Platform: WordPress and WooCommerce

1. Introduction

SmartDescribe Pro helps WooCommerce store owners create and improve image alt text using AI.

Alt text describes an image for visitors who use screen readers and provides search engines with additional context about the image. Well-written alt text can improve accessibility and support image SEO.

This guide answers common questions about SmartDescribe Pro, explains how to get the best results, and provides practical troubleshooting advice.

2. Frequently Asked Questions

What does SmartDescribe Pro do?

SmartDescribe Pro helps generate descriptive alt text for product images in your WooCommerce store. Depending on the features available in your installed version, it may also support bulk processing, scheduled optimisation, configurable writing styles, and optimisation history.

The aim is to reduce repetitive manual work while helping you maintain useful, consistent image descriptions.

Does SmartDescribe Pro write product descriptions?

No. SmartDescribe Pro focuses on image alt text, not product descriptions, product titles, or long-form marketing copy.

Its purpose is to describe what an image shows in a concise and meaningful way.

Why is alt text important?

Alt text serves several purposes:

Accessibility: Screen readers can communicate meaningful image information to visitors who cannot see the image.
Image context: Search engines can better understand what an image represents.
Fallback information: If an image cannot be displayed, alt text may provide useful context.
Content quality: Descriptive alt text helps make your product catalogue more informative.

Alt text should primarily help people understand the image. It should not be written simply to insert keywords.

Does SmartDescribe Pro guarantee better search rankings?

No. Alt text is one part of a broader accessibility and SEO strategy. Search rankings depend on many factors, including page quality, website performance, competition, technical SEO, and relevance.

SmartDescribe Pro can help you improve image descriptions, but it cannot guarantee higher rankings or increased traffic.

Which AI providers can I use?

SmartDescribe Pro may support providers such as Google Gemini, OpenAI, and Anthropic, depending on the installed version.

Check the provider options available in your plugin settings. You will generally need an API key from your selected provider.

Do I need an API key?

If your selected AI provider requires an API key, yes.

You must obtain the key from the provider, enter it in the appropriate plugin setting, and save your configuration.

Keep API keys private. Do not include them in support requests, screenshots, public posts, or website content.

Does using an AI provider cost money?

AI providers may charge for API usage according to their own pricing and account arrangements. These charges are separate from any SmartDescribe Pro purchase or licence fee.

Check your provider’s current pricing and usage limits before processing large numbers of images.

Can I optimise all my products at once?

If bulk optimisation is available in your installed version, you can use it to process multiple products rather than opening each product individually.

For your first run, test a small selection of products. Review the generated alt text before expanding to a larger catalogue.

Can I schedule optimisation?

If your version supports scheduled optimisation, you can configure it to run automatically using the scheduling options provided by the plugin.

Before enabling automation, confirm that your API provider is configured correctly and that your processing settings are appropriate for your store.

Will existing alt text be overwritten?

This depends on the plugin’s available options and the settings selected for the optimisation task.

Before running a large job, review the available controls and test them on a small group of products. Do not assume existing descriptions will be preserved unless the relevant behaviour is confirmed in your installed version.

Can I undo an optimisation?

If optimisation history and undo are available in your version, use them to review previous changes and restore supported earlier values.

Do not treat an undo feature as a replacement for a backup. Maintain a reliable website backup before making large-scale catalogue changes.

Does SmartDescribe Pro work with every WordPress theme?

Alt text is generally stored with image information in WordPress, so it is not normally tied to a particular theme. However, the way images are displayed and the way a theme or page builder uses image attributes can vary.

Test the results on your live product pages after optimisation.

Will SmartDescribe Pro optimise every image on my website?

Do not assume every image is included. The plugin’s processing scope depends on its implementation and selected options.

Check which images and products are supported by your installed version. If your store uses gallery images, variation images, banners, or images inserted directly into page content, verify whether those are included in the optimisation workflow.

3. Best Practices for High-Quality Alt Text

Describe the image accurately

Alt text should tell the reader what is visibly important in the image.

For example:

Too vague:
Product image

More useful:
Handmade ceramic mug with a blue glazed finish

The second example identifies the item and a distinguishing visible feature.

Keep descriptions concise

Alt text is not intended to be a full product description.

Avoid long paragraphs, promotional claims, and unnecessary background information. Include the details needed to understand the image.

Use keywords naturally

Relevant words can help explain what an image contains, but keyword stuffing makes alt text less useful.

Poor example:
Handmade mug ceramic mug blue mug buy handmade mug best mug online

Better example:
Handmade blue ceramic mug with a curved handle

Describe the image first. Include a search term only when it fits naturally.

Do not invent details

AI-generated text can occasionally misidentify an object, colour, material, pattern, or other visual feature.

Always review descriptions for accuracy. Do not publish claims about materials, dimensions, provenance, or product features that cannot be established from the image or reliable product information.

Give different images different descriptions

If a product has several images showing different angles or details, the alt text should reflect what is visible in each image where the workflow supports image-specific processing.

For example:

Handmade ceramic mug viewed from the front
Close-up of the blue glaze on a ceramic mug
Side view showing the curved handle of a ceramic mug

Avoid using identical descriptions for every image when they show meaningfully different details.

Avoid unnecessary phrases

Phrases such as “image of” or “picture of” are usually unnecessary because screen readers can identify images as such.

Focus on the useful description instead.

Consider decorative images

Not every image needs descriptive alt text. Images that are purely decorative may be better handled with empty alt text, depending on how they are used.

Do not automatically add lengthy descriptions to decorative elements such as ornamental flourishes or background graphics.

4. Recommended Workflow

For the best balance between efficiency and quality, use the following process.

Step 1: Prepare your store

Before optimisation:

Confirm that your WordPress and WooCommerce installations are functioning normally.
Back up your website and database.
Check that SmartDescribe Pro is installed and activated.
Confirm that the plugin’s required settings are configured.

Step 2: Configure your AI provider

Open the SmartDescribe Pro settings and select an available AI provider.

Enter the required credentials, save the settings, and use any available connection or API test function.

If the connection fails, resolve the problem before beginning bulk processing.

Step 3: Select a small test group

Choose a manageable group of products that represents the different types of images in your store.

Include products with clear photographs, multiple views, distinctive colours, and any unusual or complex items that may be difficult for AI to identify.

Step 4: Generate alt text

Use the individual or bulk optimisation workflow available in your installed version.

Review the results before applying them to your entire catalogue.

Step 5: Check the results

Look for:

Incorrect product identification.
Inaccurate colours or visible features.
Unsupported claims.
Repeated or generic wording.
Excessive keyword use.
Descriptions that are too long.
Missing descriptions for important images.

Step 6: Expand carefully

Once the test results are satisfactory, process additional products in manageable batches.

For large stores, avoid starting a very large job until you understand the processing time, provider limits, and any costs associated with API usage.

Step 7: Review the live website

Open several product pages and inspect the relevant images.

Confirm that the alt text has been saved correctly and that the descriptions accurately represent the images.

5. Troubleshooting

Problem: The AI provider does not respond

Possible causes:

An incorrect or expired API key.
Insufficient provider account balance or quota.
A provider service interruption.
Network restrictions or server configuration issues.

Recommended actions:

Check that the API key is correct.
Confirm that the provider account is active.
Check the provider’s usage limits and service status.
Retry with a single product.
Review any error message or available plugin log.

Problem: Generated alt text is inaccurate

Possible causes:

The image is unclear or low-resolution.
The image contains several objects.
The product is visually unusual.
The AI has inferred details that are not actually visible.

Recommended actions:

Review the image yourself.
Correct the inaccurate description.
Use a more suitable writing style or template if available.
Test a different AI provider if your version supports one.
Review similar products to ensure the same issue is not recurring.

AI output should always be treated as a draft that may require human review.

Problem: Bulk optimisation stops or fails

Possible causes:

API rate limits.
Server timeouts.
Memory or processing limits.
Temporary network interruptions.
An issue with a particular product or image.

Recommended actions:

Check whether the plugin reports an error.
Retry using a smaller batch, if supported.
Check your hosting environment’s error logs.
Confirm that your API provider has sufficient quota.
Test individual products to identify whether the issue affects the entire process or only certain items.

Avoid repeatedly launching large jobs without first checking whether an earlier job is still running.

Problem: Alt text does not appear to have changed

Possible causes:

The optimisation did not complete.
The existing text was retained by the selected settings.
The wrong image or product was processed.
A cache or display issue is affecting what you see.

Recommended actions:

Confirm that the operation completed successfully.
Open the relevant product and inspect its image information.
Check the plugin’s history or status information, if available.
Clear relevant caches if the saved information appears correct but the public page still shows unexpected results.
Test another product to determine whether the issue is isolated.

Problem: API usage is higher than expected

Recommended actions:

Review the number of products and images being processed.
Check the provider’s usage dashboard.
Avoid unnecessary repeat optimisation.
Use smaller batches while testing settings.
Schedule recurring jobs only when they provide a clear benefit.

Provider charges depend on the provider’s pricing and the requests made by your configuration.

6. Accessibility and SEO Checklist

Before considering an optimisation run complete, check the following:

Alt text describes the image accurately.
Important visible features are included where useful.
Descriptions are concise and understandable.
Keywords are used naturally.
Unsupported product claims have been removed.
Different images have appropriate descriptions where necessary.
Decorative images have been considered separately.
Existing descriptions have been handled according to your intended settings.
A sample of live product pages has been reviewed.
A backup is available before major catalogue changes.

Remember that accurate, useful descriptions are more important than making every alt text field as long as possible.

7. Recommended Maintenance Routine

Weekly

For stores actively adding products or running frequent optimisation jobs:

Review a sample of newly generated descriptions.
Check for repeated errors or generic wording.
Investigate any failed jobs.
Monitor API usage if your provider charges for requests.

Monthly

For ongoing catalogue maintenance:

Review a wider sample of product images.
Check that descriptions remain accurate after product changes.
Review scheduled tasks and optimisation settings.
Confirm that API credentials and provider account arrangements remain valid.
Check whether your installed plugin version has any relevant updates.

The frequency of these checks can be adjusted to suit the size and activity level of your store.

8. Quick Reference

Task	Recommended action
First-time setup	Configure the AI provider and test a small number of products
Individual optimisation	Review each result before applying it
Bulk optimisation	Start with a small batch and expand gradually
Scheduled optimisation	Confirm settings, provider limits, and expected usage
Incorrect output	Review the image and edit the generated description
Failed processing	Check API configuration, error messages, and server logs
Large catalogue changes	Back up the website before proceeding
SEO review	Prioritise accuracy, relevance, and natural wording
Accessibility review	Ensure meaningful images have useful descriptions

9. Final Recommendations

SmartDescribe Pro can reduce the time required to maintain product image alt text, particularly in stores with large catalogues.

For the best results:

Configure your AI provider correctly.
Test a small number of products before processing the entire catalogue.
Review generated descriptions for accuracy.
Avoid keyword stuffing and unsupported claims.
Monitor bulk jobs and API usage.
Maintain backups before large-scale changes.
Review the live website after optimisation.

The goal is not simply to generate more alt text. It is to make image descriptions more accurate, accessible, and useful to your customers.

SmartDescribe Pro is a Cazgrae product. Available features and menu labels may vary by installed version.