SmartDescribe Pro Store Owner’s Complete Operational Handbook | WooCommerce Plugins & Enhancements

Guide 1.20: Store Owner’s Complete Operational Handbook

1. Introduction

SmartDescribe Pro is designed to help WooCommerce store owners improve image alt text using AI, reducing the time and effort required to maintain product image descriptions.

This handbook brings together the main activities involved in operating SmartDescribe Pro, from initial configuration to ongoing optimisation and quality assurance.

It is intended to be a practical reference for store owners, administrators and staff responsible for maintaining a WooCommerce product catalogue.

By the end of this guide, you should understand how to:

Prepare your store for SmartDescribe Pro.
Configure an AI provider.
Optimise individual product images.
Use bulk optimisation efficiently.
Establish suitable description preferences.
Review and correct generated alt text.
Maintain accessibility and SEO best practices.
Troubleshoot common problems.
Establish a repeatable maintenance routine.

Important: Available settings, menu labels and functionality may vary by installed version. Follow the options displayed in your current SmartDescribe Pro installation rather than assuming that every feature described in this handbook is available in every release.

2. Understanding SmartDescribe Pro

Image alt text is an HTML attribute that provides a text alternative for an image.

For a WooCommerce store, useful alt text helps customers who cannot see an image understand its relevant content. It can also help search engines interpret product imagery.

For example, a photograph of a handmade mosaic ornament might use:

Handmade mosaic cat garden ornament with colourful tile detailing

The description identifies the subject and communicates a relevant visual characteristic without unnecessary promotional language.

SmartDescribe Pro uses AI to assist with generating image descriptions, helping store owners manage this work more efficiently.

The quality of the result depends on factors such as:

The clarity and content of the image.
The AI provider and model being used.
The instructions and preferences available in the plugin.
The nature of the product.
The context in which the image appears.
Whether the generated description is reviewed and corrected.

AI-generated descriptions should not be treated as automatically perfect. Human review remains important, particularly for valuable, distinctive or visually complex products.

3. Before You Begin

Before installing or configuring SmartDescribe Pro, complete the following checks.

3.1 Confirm your environment

Check that your website is running WordPress and WooCommerce versions compatible with your installed SmartDescribe Pro release.

Also consider:

Your current PHP version.
Your hosting provider’s resource limits.
Whether your website uses caching or security plugins.
Whether other plugins modify product images or attachment metadata.
Whether your website has a recent backup.

Compatibility should be confirmed against the requirements for your specific release.

3.2 Back up your website

Before making substantial changes to product metadata or running a large optimisation task, create a recent backup.

The backup should cover the database and relevant website files.

Image alt text is generally stored in WordPress attachment metadata. A database backup is therefore particularly important when changing large numbers of image descriptions.

Confirm that your backup process can restore the relevant data before undertaking large-scale changes.

3.3 Prepare your AI provider

SmartDescribe Pro may support one or more external AI providers, depending on the installed version.

You may need an API key from a supported provider.

Common provider key-management pages include:

Google Gemini: https://aistudio.google.com/apikey
OpenAI: https://platform.openai.com/api-keys
Anthropic: https://console.anthropic.com/settings/keys

Check the plugin’s current provider list before creating an account or purchasing API access.

API usage may incur charges depending on your provider, account, model and usage level.

4. Installation and Activation

If SmartDescribe Pro is not already installed, follow the installation instructions supplied with your plugin package.

A typical WordPress installation involves:

Sign in to your WordPress administration dashboard.
Open Plugins → Add New Plugin.
Select the option to upload a plugin ZIP file.
Choose the SmartDescribe Pro installation package.
Upload and install the package.
Activate the plugin.
Confirm that its administration menu appears.

The exact labels may differ between WordPress versions.

If SmartDescribe Pro is already installed and working, you do not need to reinstall it simply to follow this handbook.

Installation checks

After activation:

Confirm that the WordPress dashboard loads normally.
Check that WooCommerce remains active.
Locate the SmartDescribe administration menu.
Open the available settings.
Look for any activation or configuration notices.
Confirm that no PHP errors or critical website errors have appeared.

If activation produces an error, stop and resolve the problem before attempting bulk optimisation.

5. Configuring Your AI Provider

The AI provider supplies the model used to generate descriptions.

Depending on the available plugin settings, you may be able to choose between supported providers or models.

Recommended configuration process

Step 1: Open the plugin settings

Navigate to the SmartDescribe settings area, commonly displayed as SmartDescribe → Settings.

Step 2: Select a supported provider

Choose a provider listed by your installed version.

Step 3: Enter the API key

Copy the key from your provider account and enter it in the designated field.

Avoid including extra spaces or characters.

Step 4: Select any available model or preferences

If model selection is available, choose a model supported by both the provider and the plugin.

Step 5: Save your settings

Use the plugin’s save function and wait for confirmation.

Step 6: Test the connection

If a connection-testing feature is provided, run it and review the result.

Step 7: Optimise a test image

Generate a description for one product image and inspect the result.

A successful API connection confirms that communication is working. It does not guarantee that every generated description will be accurate.

API key security

Treat your API key as a password.

Do not publish it on your website.
Do not include it in screenshots shared publicly.
Do not place it in publicly accessible files.
Restrict access to WordPress administrator accounts.
Review provider usage and billing periodically.
Revoke and replace exposed keys.

The provider’s account and billing policies determine how API usage is charged.

6. Establishing Your Description Standards

Before processing a large catalogue, decide what good alt text should look like for your business.

A useful default standard is:

Write a clear, concise and accurate description of the image. Identify the main subject and include relevant visible details. Avoid unsupported claims, promotional wording and unnecessary keyword repetition.

For product images, useful details may include:

The product’s identity.
Dominant colours.
Distinctive patterns or decorative features.
Visible materials or textures when they can be identified reliably.
A relevant angle or view of the product.
Other visual characteristics that distinguish the item.

Do not use alt text to replace the full product description.

For example, the product description may explain dimensions, delivery arrangements, care instructions and product availability. The image alt text should focus on what the image communicates.

Example

A handmade mosaic mushroom ornament might use:

Purple and yellow mosaic mushroom garden ornament

A longer description may be appropriate when additional visible details help distinguish the image:

Purple mosaic mushroom ornament with yellow spots and a rounded decorative cap

Choose the wording that accurately reflects the actual photograph.

Avoid keyword stuffing

Do not use a string of unrelated search terms such as:

Mosaic mushroom garden art handmade gift garden ornament outdoor decor best gift

A description should read naturally and communicate useful information.

7. Optimising an Individual Product Image

Individual optimisation is a good starting point when configuring SmartDescribe Pro or checking how it performs on your products.

Step 1: Select a test product

Choose a product with a clear image and familiar characteristics.

Avoid beginning with a complicated image containing several objects or a visually ambiguous subject.

Step 2: Open the product

Navigate to the WooCommerce product list and open the selected product.

Step 3: Identify the image

Confirm which image you intend to optimise.

Do not assume that optimising a product automatically processes every image in its gallery. Image coverage depends on the plugin’s supported workflow.

Step 4: Run the available optimisation action

Use the individual optimisation control provided by SmartDescribe Pro.

The precise button label and location may vary by version.

Step 5: Inspect the generated alt text

Compare the description with the actual image.

Check that the AI has not:

Identified the wrong object.
Misrepresented the colours.
Invented a material or product feature.
Added unnecessary marketing language.
Produced repetitive wording.
Omitted a distinctive visible feature.

Step 6: Save and verify

If the description is suitable, confirm that it has been saved.

If it needs correction, edit the alt text using the appropriate supported workflow.

Reopen the image or product to verify that the saved description is correct.

Best practice: Always test a small number of products before expanding to the rest of your catalogue.

8. Managing Bulk Optimisation

Bulk optimisation is useful for stores with many products.

It can reduce repetitive manual work, but it also increases the potential impact of incorrect settings or poor-quality output.

SmartDescribe Pro’s bulk controls should be used carefully and in stages.

Before starting

Confirm that:

Your AI provider is configured correctly.
A recent backup is available.
Your test descriptions meet your quality standards.
You understand which products and images are included.
You know whether existing alt text may be replaced.
You have checked the available processing and scheduling options.
Your hosting environment can handle the expected workload.

Recommended bulk workflow

Stage 1: Select a small group

Start with a manageable group of products representing different product types.

Stage 2: Review the results

Inspect the generated descriptions and identify any recurring errors.

Stage 3: Adjust your configuration

If available, refine the writing preferences, model selection or other relevant settings.

Stage 4: Expand gradually

Process larger groups only after the initial results meet your standards.

Stage 5: Monitor progress

Use the plugin’s available progress indicators, logs or status information.

Stage 6: Verify completion

Check the final status and inspect a sample of processed images.

Do not assume that a task has completed successfully simply because it has started.

Protecting existing descriptions

Before a bulk run, establish whether the operation skips existing alt text, overwrites it or offers a choice.

If the behaviour is unclear, test it on a small number of products first.

Preserve important manually written descriptions wherever possible.

9. Scheduled Optimisation and Automation

If your installed version supports scheduled optimisation, automation may help process eligible images without requiring you to start each task manually.

However, scheduling should be introduced only after the basic workflow has been tested.

Before enabling it, confirm:

Which images or products are eligible.
Whether existing descriptions can be replaced.
How frequently processing runs.
Whether tasks are processed in batches.
How failures are reported.
Whether you can pause or disable the schedule.
Whether the AI provider’s usage costs are acceptable.

Start with a limited workload and monitor the results.

Automation should not be assumed to review existing descriptions for accuracy unless that specific capability is documented and available in your version.

Recommended approach: Use automation to reduce repetitive work, while maintaining a separate process for checking quality.

10. Reviewing History and Correcting Mistakes

If your version includes optimisation history or undo functionality, understand its limitations before relying on it.

Review any available history records to determine:

Which item was processed.
When the operation occurred.
What change was made.
Whether the previous description was retained.
Whether the operation completed successfully.

If an incorrect description is generated, correct it as soon as possible.

Where a supported undo function exists, confirm which value will be restored before using it.

Do not assume that undo can reverse every change, recover every previous value or restore an entire bulk operation unless the installed version explicitly supports that behaviour.

For important catalogue changes, a verified backup provides an additional recovery option.

11. Accessibility and SEO Best Practices

Alt text serves an accessibility purpose first.

It provides a text alternative for meaningful images and can also help search engines understand image content.

Write for the customer

Describe the image in a way that helps someone who cannot see it understand the relevant information.

Avoid unnecessary phrases such as “image of” or “picture of” when they add no useful information.

Do not describe every visible detail

Focus on the details that matter to the image’s purpose.

A product photograph may need only a short description, while a complex graphic may require a fuller explanation elsewhere on the page.

Consider decorative images

Decorative images that communicate no meaningful information should generally use an empty alt attribute:

alt=""

This is different from an image that is missing an alt attribute entirely.

Avoid unsupported claims

An image may show an object, colour or pattern, but it may not establish exact dimensions, safety characteristics or weather resistance.

Keep factual product specifications in the appropriate product information fields.

Understand SEO limitations

Appropriate alt text can support image discoverability, but it does not guarantee improved rankings, increased traffic or more sales.

Avoid rewriting accurate alt text simply to insert additional keywords.

12. Quality Assurance for Your Catalogue

A repeatable review process helps maintain consistency as your store grows.

Use the following checklist when auditing descriptions.

Check	What to look for
Accuracy	Does the description match the image?
Relevance	Does it communicate useful visual information?
Clarity	Is the wording easy to understand?
Conciseness	Can unnecessary words be removed?
Context	Does the description suit the image’s role?
Duplication	Are repeated descriptions appropriate for the images concerned?
Integrity	Does the text avoid invented details and unsupported claims?
Accessibility	Is meaningful content described appropriately?

For large catalogues, prioritise:

Best-selling products.
Featured products.
Important landing pages.
New products.
Products with known alt text problems.
The remaining catalogue.

You can record audit results in a spreadsheet if your plugin version does not provide a dedicated audit report.

Useful tracking fields include the product name, product ID, image identifier, current alt text, review result, correction required and review date.

13. Performance and Large Catalogues

AI processing can require external API requests and additional server resources.

Large workloads may be affected by:

API rate limits.
Provider usage limits.
Network interruptions.
Server timeouts.
PHP resource limits.
Background task scheduling.
Other plugins running resource-intensive operations.

Recommended performance practices

Process in manageable batches.

Avoid beginning with the entire catalogue if you have not tested the workflow.

Monitor provider usage.

Review API usage and billing information through your provider account.

Avoid unnecessary repeated processing.

Do not regenerate descriptions without a clear reason, particularly if the existing text is accurate.

Allow tasks to finish.

If a bulk operation is in progress, avoid repeatedly starting the same job unless the plugin documentation explains that doing so is safe.

Investigate incomplete tasks.

Review the available status information and logs before retrying failed work.

Coordinate major maintenance.

Avoid scheduling large optimisation runs at the same time as other demanding website tasks.

The correct batch size depends on your catalogue, hosting environment, provider limits and plugin implementation.

14. Troubleshooting Common Problems

Problem: The AI provider connection fails

Possible causes include an invalid API key, incorrect provider selection, insufficient account access, usage limits or a temporary service interruption.

What to do:

Confirm that the selected provider is supported.
Check the API key.
Confirm that the provider account is active.
Review usage limits and billing.
Retry the connection test if available.
Review any error message provided by the plugin.

Problem: Optimisation produces an error

Possible causes include a provider failure, network interruption, timeout or invalid request.

What to do:

Record the error message.
Try a single test image.
Check whether other images process successfully.
Review provider status and usage limits.
Check the available WordPress or plugin logs.
Retry only after identifying or reasonably addressing the problem.

Problem: The generated alt text is inaccurate

What to do:

Correct the affected description.
Check whether the problem occurs across similar images.
Review available writing preferences or provider settings.
Test a small group again before continuing a large run.

Problem: Existing alt text has changed unexpectedly

What to do:

Stop further processing if a bulk job may be responsible.
Identify which images were affected.
Check whether the workflow overwrites existing descriptions.
Review any available history or undo facility.
Restore the correct descriptions using the supported recovery method.

Problem: Bulk processing stops before completion

What to do:

Check the task status.
Look for errors or failed items.
Review provider limits and server resources.
Determine whether the plugin supports safe resumption.
Retry only the affected items where possible.

Problem: The website develops an error after installation or an update

What to do:

Avoid repeatedly activating or updating the plugin without investigating.
Record the error message and when it appeared.
Check compatibility requirements.
Review relevant WordPress or hosting logs.
Use your established recovery procedure if the website is affected.
Contact support with the relevant technical information.

Do not share API keys, passwords or other secrets when reporting a problem.

15. Privacy and Security

SmartDescribe Pro may send image-related information to an external AI provider to generate descriptions.

Before processing images, review the provider’s terms, privacy information and data-handling practices.

Consider whether your images contain:

Personal information.
Customer-identifying details.
Confidential business material.
Information subject to contractual or legal restrictions.

Only process material that you are authorised to submit to the selected provider.

Additional safeguards include:

Limiting WordPress administrator access.
Keeping WordPress, WooCommerce and plugins updated.
Protecting API credentials.
Monitoring unexpected API usage.
Reviewing your provider’s retention and data-use policies.
Avoiding the publication of confidential information in support requests.

Do not assume that every AI provider handles submitted data in the same way. Review the policies that apply to your particular account and service.

16. Updates and Version Management

Keeping SmartDescribe Pro updated helps maintain compatibility and access to supported improvements.

Before updating:

Review the release notes.
Check the stated compatibility requirements.
Back up the website.
Confirm that no critical bulk task is running.
Apply the update using the supported installation process.
Test the plugin settings.
Optimise a single image.
Confirm that WooCommerce and the rest of the website still work normally.

For a major update, consider testing on a staging website first.

After updating, recheck important settings rather than assuming every preference has been retained.

If a problem appears, record the installed version and the steps that reproduce it before contacting support.

17. A Practical Operating Schedule

The following routine provides a starting point for maintaining SmartDescribe Pro.

When adding new products

Confirm that the product images are suitable for use.
Check whether meaningful images already have appropriate alt text.
Optimise missing or unsuitable descriptions using the supported workflow.
Review the results.
Verify that the saved text is correct.

Weekly

For stores adding products regularly:

Check recently added products.
Review any failed or incomplete optimisation tasks.
Investigate recurring errors.
Monitor unusual API usage.

Smaller stores may need this review less frequently.

Monthly

Audit a sample of important product images.
Review any descriptions flagged as inaccurate.
Check whether recent changes to the catalogue require further work.
Review provider usage and costs.
Confirm that scheduled tasks, if enabled, are behaving as expected.

Quarterly

Review the broader catalogue.
Prioritise products that have not been audited recently.
Check plugin and compatibility updates.
Review access to API credentials.
Evaluate whether your optimisation process remains suitable for the size of your store.

This schedule is a suggested operating routine. Adjust it to suit the volume and frequency of changes in your catalogue.

18. Store Owner’s Quick Reference

Task	Recommended action
First-time setup	Confirm compatibility, install the plugin and configure a supported AI provider.
First optimisation	Test one image and inspect the generated description.
New product	Check the alt text for each relevant product image.
Large catalogue	Use tested bulk processing in manageable groups.
Scheduled processing	Confirm eligibility, overwrite behaviour, monitoring and costs before enabling it.
Incorrect description	Correct the text and investigate whether similar images are affected.
Unexpected changes	Pause further processing and investigate history, backups and overwrite behaviour.
Provider error	Check credentials, provider status, usage limits and error details.
Major update	Back up, update carefully and test the core workflow.
Routine maintenance	Review important images, unresolved errors and provider usage.

19. Frequently Asked Questions

Can SmartDescribe Pro optimise my entire WooCommerce catalogue?

Bulk optimisation can help process multiple products, subject to the capabilities of your installed version and the limits of your hosting environment and AI provider. Start with a small group and expand gradually.

Will every image receive alt text automatically?

That depends on the images included in the supported workflow and the plugin’s behaviour. Do not assume that every product image, gallery image or decorative image is automatically covered.

Should I replace all existing alt text with AI-generated descriptions?

No. Existing descriptions may already be accurate and useful. Establish how the plugin handles existing text before running a bulk operation, and preserve high-quality manual descriptions where appropriate.

Can I use SmartDescribe Pro without an AI API key?

That depends on the functionality and configuration of your installed version. If the selected feature requires an external AI provider, you will need valid provider access.

Does SmartDescribe Pro guarantee better SEO?

No. Appropriate alt text can help search engines understand images, but rankings depend on many factors. Accessibility and descriptive accuracy should remain the priorities.

Should I use the same writing style for every product?

Consistency is helpful, but descriptions should still reflect the individual image. Use available preferences or templates where appropriate without forcing every image into an unsuitable formula.

Can I leave optimisation running automatically?

Use scheduled processing only if your installed version supports it. Monitor the workload, provider usage and output quality, and ensure you can pause the process if problems occur.

What should I do if an AI-generated description is wrong?

Correct the description, check whether similar errors affect other products and review your configuration before continuing with a large batch.

How often should I audit my catalogue?

Review new products as they are added, sample important images regularly and conduct broader audits according to the size and activity of your store.

20. Final Operational Checklist

Use this checklist when establishing or reviewing your SmartDescribe Pro workflow.

Setup

WordPress and WooCommerce compatibility has been checked.
The plugin is installed and activated correctly.
A supported AI provider is configured.
API credentials are stored securely.
A recent backup is available.

Configuration

Description standards have been established.
Available writing preferences have been reviewed.
A representative group of products has been tested.
Existing alt text handling has been checked.

Daily operation

Individual optimisation has been tested.
Bulk processing is performed in manageable groups.
Results are checked for accuracy.
Failed or incomplete tasks are investigated.
API usage is monitored.

Quality assurance

Important product images have appropriate descriptions.
Incorrect descriptions are corrected.
Decorative images are treated appropriately.
Duplicate descriptions are reviewed in context.
Unsupported product claims are removed.
Ongoing audits are scheduled.

Maintenance

Plugin updates are reviewed before installation.
Backups are maintained.
Provider credentials and usage are reviewed.
Technical issues are documented.
A recovery process is available for unexpected changes.

21. Conclusion

SmartDescribe Pro can make image alt text management more efficient, particularly for WooCommerce stores with growing product catalogues.

The best results come from combining automation with sensible configuration, careful testing and ongoing quality assurance.

The recommended approach is straightforward:

Configure the plugin correctly.
Test the output on a small number of products.
Expand to bulk optimisation when the results are satisfactory.
Review important descriptions and correct mistakes.
Protect existing data and API credentials.
Maintain a regular audit and update routine.

A successful SmartDescribe Pro workflow is not measured by how many descriptions AI generates. It is measured by how consistently your store provides accurate, relevant and accessible image descriptions to customers.