=== SOOZ - AI for SEO – Bulk Generate Focus Keyphrases, Metadata, Alt Text (SEO Autopilot) ===
Tags: seo, ai, google search console, alt text, bulk
Contributors: spacecodes
Donate link: https://spa.ce.codes
Requires at least: 4.7
Tested up to: 6.9
Stable tag: 2.3.3
Requires PHP: 7.4
License: GPL-2.0-or-later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Lightweight SEO Autopilot that works with Yoast SEO, Rank Math, SEOPress, WooCommerce etc. to bulk-generate keyphrases, meta tags, alt text and more.

== Description ==
*SOOZ - AI for SEO* is an **alt text & metadata bulk generator** with **SEO Autopilot**, optimize pages, posts, products, and images automatically. Built for WooCommerce SEO and high-volume sites.

Sync generated focus keyphrases, meta titles, meta descriptions and social-media tags to your existing stack (Yoast SEO, Rank Math, SEOPress, and others). Use ‘Generate with SOOZ’ buttons where you work: Block Editor (Gutenberg), Media Library, Elementor, BeTheme’s BeBuilder, or the top admin bar. Think of *SOOZ - AI for SEO* as your SEO Copilot wherever you edit.

Achieve better metadata and alt text results than with ChatGPT. *SOOZ - AI for SEO* understands your entire website and uses expertly crafted SEO prompts designed to drive real search traffic.

**Image SEO at scale:** Create alt text, image titles, captions, and descriptions across your library (jpg, png, gif, webp, avif).

**Accessibility-ready:** Helps meet European Accessibility Act (EAA) requirements by automatically generating missing alt text for a more inclusive experience.

**Free for most small/medium sites:** If your balance falls below 100 Credits, we add 5 free Credits daily, so you can keep generating at no cost.

= 🚀 How to Get Started =
1. **Open the Dashboard:** Go to "SOOZ - AI for SEO" to view statistics about your current SEO coverage.
2. **Review your content:** Open "Pages", "Posts", "Products", or "Media" and check its SEO status.
3. **Set up Autopilot:** Click "Set up SEO Autopilot", choose content types (Pages/Posts/Products/Media), and start bulk generation.
4. **Get a first win (optional):** In the "Media Library", click "Generate with SOOZ" on one image to create optimized alt text within seconds.
5. **Fine-tune manually:** Use "Generate with SOOZ" buttons or the top admin-bar "SOOZ - AI for SEO" button to open the Metadata Editor for any page or post.
6. **Sync with your SEO plugin (optional):** In "Settings" -> Sync "SOOZ - AI for SEO" Changes, select Yoast SEO, Rank Math, SEOPress or many more to keep metadata updated.

For a step-by-step guide, see "Help" -> "Getting Started" -> "First Steps".
Need help? Email [support@sooz.ai](mailto:support@sooz.ai).

= 💸 100% Risk-Free Money-Back Guarantee! =
Within 14 days of your first purchase (subscription: Basic/Pro/Premium, or Credits Pack), if *SOOZ - AI for SEO* isn’t a fit, email [support@sooz.ai](mailto:support@sooz.ai). We’ll refund 100%, no questions asked.

= 🔌 Editor integrations =
Create and edit metadata right where you work, no context switching.

- **Block Editor (Gutenberg)**
- **Media Library** (image attributes)
- **Elementor**
- **BeTheme BeBuilder**
- **Yoast SEO Settings**

We add 'Generate with SOOZ' buttons in these editors so you can create SEO titles, descriptions, and image attributes in one click. It’s like having an SEO Copilot inside each editor.
You can also click the *SOOZ - AI for SEO* button in the top admin bar to open the Metadata Editor from any page or post.

= 🎯 Key Features =
✅ **SEO Autopilot (bulk):** Automatically generate and refresh metadata for new and existing content.
✅ **Alt text & image attributes:** Create alt text, titles, captions, and descriptions site-wide (jpg/png/gif/webp/avif).
✅ **WooCommerce SEO:** Optimize product metadata to attract higher-intent buyers from search.
✅ **Sync with your SEO plugin:** Keep metadata updated in Yoast SEO, Rank Math, SEOPress, and others.
✅ **Edit where you work:** "Generate with SOOZ" in the Block Editor (Gutenberg), Media Library, Elementor, BeBuilder, and Yoast SEO. An SEO Copilot embedded in your workflow.
✅ **Accessibility-ready:** Helps meet European Accessibility Act (EAA) requirements by automatically generating missing alt text for a more inclusive experience.
✅ **Progress tracking:** Monitor coverage and recent activity from the Dashboard.
✅ **For agencies & teams:** White-label, incognito mode, export/import settings, Multisite support.
✅ **One account, many websites:** Share subscriptions or Credits Packs across any number of sites.
✅ **Flexible credits:** Free daily Credits for low balances, plus rollover and Pay-As-You-Go options.

= 🔗 Integrations & Compatibility =
*SOOZ - AI for SEO* works with leading SEO plugins, page builders, e-commerce, multilingual tools, galleries, and popular themes, so you can generate and sync metadata where you already work. *SOOZ - AI for SEO* is designed to work alongside these plugins and themes, not replace them, so your existing setup continues to function normally while *SOOZ - AI for SEO* generates and syncs the SEO data.
See the list below for confirmed compatibility.
✅ Yoast SEO
✅ Rank Math
✅ All in One SEO
✅ SEO Simple Pack
✅ SEOPress
✅ Slim SEO
✅ Squirrly SEO
✅ The SEO Framework
✅ Blog2Social
✅ SEOKEY
✅ WPML
✅ BeTheme
✅ Elementor
✅ WooCommerce
✅ NextGen Gallery
✅ MemberPress
✅ Divi

If your favorite plugin or theme isn’t listed, please email us the name, URL, and the fields you’d like to sync, we prioritize new compatibility based on demand: [support@sooz.ai](mailto:support@sooz.ai)
Focus keyphrases and meta tags are automatically imported from Yoast SEO, Rank Math, and other supported plugins. You can review, modify, and regenerate this data at any time, then sync it back to your preferred SEO plugin.

== Installation ==

Install like any other WordPress plugin.

**Dashboard (search)**
1. Log in to WordPress and go to "Plugins -> Add New".
2. Search for *SOOZ - AI for SEO* and select the plugin.
3. Click "Install", then "Activate".

**Dashboard (upload a ZIP)**
1. Download the plugin ZIP.
2. In WordPress go to "Plugins -> Add New -> Upload Plugin".
3. "Choose File" -> select the ZIP -> "Install Now" -> "Activate".

**Manual upload (FTP/SFTP)**
1. Unzip the archive and upload the "ai-for-seo" folder to "wp-content/plugins/".
2. In WordPress, go to "Plugins" and click "Activate" for *SOOZ - AI for SEO*.

**WP-CLI (advanced)**
wp plugin install ai-for-seo --activate

**After activation**
Open "SOOZ - AI for SEO" in the admin menu to view your SEO coverage and click "Set up SEO Autopilot" to start bulk generation.


== Screenshots ==

1. Dashboard (screenshot-1.jpg)
2. Media page (screenshot-2.jpg)
3. Metadata Editor (screenshot-3.jpg)
4. Media Library (screenshot-4.jpg)
5. SEO Autopilot Setup (screenshot-5.jpg)
6. Settings for SEO and Web Agencies (screenshot-6.jpg)


== Frequently Asked Questions ==

= Can I use *SOOZ - AI for SEO* alongside another SEO plugin? =
Yes, *SOOZ - AI for SEO* is compatible with all major SEO plugins. The metadata generated by *SOOZ - AI for SEO* can be synchronized with popular plugins such as Yoast SEO, Rank Math, SEOPress, All in One SEO, Slim SEO, SEO Simple Pack, Squirrly SEO, The SEO Framework, and Blog2Social. This ensures your metadata remains up-to-date and seamlessly integrates with your preferred SEO tool.

= How do I avoid duplicate meta tags with other SEO plugins? =
Use the output mode in Settings. Choose between Disable, Force, Replace (default), or Complement existing meta tags to match your setup with Yoast, Rank Math, SEOPress, etc.

= Will the AI tool automatically analyze my content? =
Yes, the AI tool will generate SEO-relevant data based on the content of the selected page, blog post or media file.

= Will *SOOZ - AI for SEO* overwrite my existing metadata or media attributes? =
Not unless you enable it. By default, we don’t overwrite existing data. You can explicitly allow overwriting (and even include “complete” entries) in Settings.

= Can I choose which media attributes the plugin should generate? =
Yes, *SOOZ - AI for SEO* lets you decide which media attributes (like "alt text" or "title") should be generated. You can configure this in the "Active Media Attributes:" section of the Settings to match your content needs. Simply select the desired attributes and the SEO Autopilot will generate the data accordingly.

= How are Credits consumed in the *SOOZ - AI for SEO* plugin? =
Credits are used when *SOOZ - AI for SEO* generates metadata for your content (posts, pages, products, media files etc.). The amount of Credits required depends on the selected active meta tags and media attributes (see Settings).

= Do unused Credits expire at the end of the month? =
No, any unused Credits will roll over to the next month, allowing you to fully utilize your Credits without losing them at the end of each billing cycle.

= Can I try the *SOOZ - AI for SEO* plugin without purchasing a subscription? =
Yes, the free plan provides you with 100 Credits, allowing you to experiment with AI-generated SEO content without any cost. In addition, we provide you with 5 free Credits every day if your balance falls below 100 Credits.

= When should I choose a Subscription, Credit Packs, or Pay-As-You-Go? =
1. Choose **Subscription** if you want ongoing features and steady Credits. Subscriptions unlock advanced generation options and provide a continuous flow of Credits for new content over time.
2. Choose **Credit Packs** for one-time top-ups when you need a larger burst of generations. Credit Packs are ideal as an add-on to an active subscription when you temporarily need more Credits.
3. Choose <strong>PAYG (Pay-As-You-Go)</strong> if you prefer automatic top-ups. When your balance falls below 100 Credits, new Credits are added to your account automatically by purchasing a package you selected in advance.

= Where can I log in to my SOOZ – AI for SEO account / customer portal? =
We currently do not offer a separate customer portal. All account-related actions, including subscription and payment management, can be accessed through the WordPress plugin.
You can find the relevant links in your WordPress admin area under “SOOZ – AI for SEO” > “Account”.

= Where can I download my invoice? =
A download link for your invoice is included in the confirmation email sent after each purchase.
If you currently have an active subscription, you can also access and download your invoices through the WordPress plugin under “SOOZ – AI for SEO” > “Account” > “Manage Subscription / Invoices”.

= Does *SOOZ - AI for SEO* support multi-language websites? =
Yes, the plugin does support multi-language websites. The plugin also supports the WPML-plugin through which you can generate metadata and media attributes for all available languages separately.

= Does *SOOZ - AI for SEO* support Multisite installations? =
Yes, *SOOZ - AI for SEO* fully supports Multisite installations. Simply purchase a subscription on your primary website and use the same license owner and license key across all your sub-sites.

= Can I use *SOOZ - AI for SEO* on a staging or local development site? =
Yes, you can use *SOOZ - AI for SEO* on staging or local development sites.

= What editors are supported? =
*SOOZ - AI for SEO* supports most editors and themes. For extra convenience, we've added dedicated “Generate with SOOZ” buttons in Elementor, BeTheme (Muffin-Builder / Be-Builder), and the standard editor. You can also generate metadata directly from the plugin dashboard, the metadata editor, or SEO Autopilot without using any page builder.

= Can I link multiple sites and share credits/settings? =
Yes. Enter the same license owner + key under *SOOZ - AI for SEO* > Account on each website to link them. Linked websites share the same credits pool, and you can export/import settings between them. Works with Multisite and staging.

= I’m an agency with multiple client websites. How do I set things up? =
1. We recommend setting up your agency *SOOZ - AI for SEO* account via a primary site (e.g., your agency site) and purchasing a subscription there. Alternatively, you can purchase directly on our website: https://sooz.ai/pricing
2. After purchasing a subscription, you receive your license owner and key by email and they are also visible in your *SOOZ - AI for SEO* Account area.
3. Install the *SOOZ - AI for SEO* plugin on each client website you manage. Go to *SOOZ - AI for SEO* > Account on each website.
4. Enter the **same license owner + key** to link them to the same account. Linked websites share the same subscription and Credits pool.

= Does *SOOZ - AI for SEO* collect or store my content? =
*SOOZ - AI for SEO* sends only the text needed to generate metadata to our AI service. We don’t add tracking scripts to your site, and we don’t publish your content. You can review privacy options (generator hints, white-label, incognito) under *SOOZ - AI for SEO* > Account > Privacy & Agreements.

= Can I control who can use *SOOZ - AI for SEO* in my WordPress? =
Yes. In Settings, you can restrict access by user role. Agencies can also use Incognito and White-Label options in *SOOZ - AI for SEO* > Account.

= Is AI-generated SEO-content harmful to my SEO-ranking? =
Currently, Google's stance on the use of AI or automation in content creation is generally permissive, as indicated in a Google Developers blog post from February 2023. They state that appropriate use of AI or automation is not against their guidelines. More information can be found at [https://developers.google.com/search/blog/2023/02/google-search-and-ai-content](https://developers.google.com/search/blog/2023/02/google-search-and-ai-content).

= Will all the generated data disappear if I uninstall the plugin? =
It depends on how the metadata is stored and used. If *SOOZ - AI for SEO* has synchronized the generated metadata with a third-party SEO plugin like Yoast SEO, Rank Math, SEOPress, or similar, then the metadata will remain even after uninstalling *SOOZ - AI for SEO*. You can check and enable synchronization in your *SOOZ - AI for SEO* Settings. However, if synchronization was not enabled during generation, then those meta tags will disappear once the plugin is deactivated or uninstalled.

= Can you add feature x, y or z to the plugin? =
We are always open to suggestions and feedback. Please email us at [support@sooz.ai](mailto:support@sooz.ai) with your suggestions.


== Changelog ==

= 2.3.3 =
* Better image usage detection for Elementor and BeTheme. To ensure this works properly, please enable the "Deep Search for Image Usage" setting.
* Moved the "Active Authors", "Active Media Authors", and "Active Categories (taxonomy terms)" settings out of Advanced Settings so they are easier to find.
* Moved the metadata and media attribute "Prefix / Suffix" settings into Advanced Settings.
* Added keyboard shortcuts for faster confirmations: Press Escape to close the active modal, or Enter to trigger the first primary button in the active modal or current page.

= 2.3.2 =
* Added an advanced setting to filter posts by author
* Added an advanced setting to filter media files by author
* Added an advanced setting to filter by category (taxonomy terms) and a setting to always exclude entries with disabled categories.
* Bug Fixes & Maintenance: Fixed 3 minor bugs and resolved 1 security issue.

= 2.3.1 =
* Bug Fixes & Maintenance: Fixed 6 minor bugs and resolved 3 security issues.

= 2.3.0 =
* Changed branding from "AI for SEO" to "SOOZ - AI for SEO". Visit sooz.ai for more information.
* Enhanced the quality of alt text and image attribute generation by incorporating a broader context from the surrounding content, resulting in more accurate descriptions.
* Performance improvements across multiple areas. The plugin should feel more responsive on large sites.
* Posts and Media lists now show all languages. Entries are labeled and can be filtered by WPML language.
* New advanced setting: Toggle frontend cache purging after metadata updates.
* Added a warning when leaving a page or modal with unsaved changes, on various editors and settings pages.
* Added a feedback modal on plugin deactivation, so users can share why they are leaving.
* Added a new "Remove License" button on the account page.
* Added a new setting "Query IDs Chunk Size": Advanced troubleshooting option to adjust chunk size when processing large amounts of entries. Lower values may reduce database load and fix MySQL-related issues. Higher values can improve performance if your database allows it.
* Bug Fixes & Maintenance: Fixed 21 minor bugs, implemented 9 usability improvements, implemented 14 performance optimizations, and resolved 13 security issues.

= 2.2.5 =
* Added an advanced setting to adjust the Focus Keyphrase behavior during SEO Autopilot when existing metadata is present.
* Bug Fixes & Maintenance: Fixed 4 minor bugs and implemented 2 usability improvements, and resolved 2 security issues.

= 2.2.0 =
* Changed how Credits are consumed. Credits are now charged per generated field instead of per entry. Use the “Active Meta Tags” and “Active Media Attributes” settings to control which fields are generated and how many Credits each action requires.
* Added Focus Keyphrase generation, editing, and syncing for Yoast SEO and Rank Math.
* Added Meta Keywords generation, editing, and front-end output.
* Added WooCommerce price inclusion modes for AI-generated metadata (Never, Fixed Price, Dynamic Price).
* Added additional “Generate with SOOZ” buttons inside the Gutenberg editor when Rank Math is active.
* Added “Generate with SOOZ” buttons for Focus Keyphrase (Yoast SEO) and Focus Keyword (Rank Math) inside their editors.
* Added a filter bar to the Posts and Media views including SEO-status filters and a text search.
* Added placeholder support for prefixes and suffixes across all syntaxes ({TITLE}, [TITLE], %%TITLE%% and their placeholder variants).
* Added a setting to include existing values when generating metadata and media attributes (Basic Plan+).
* Added a setting to enable enhanced entity recognition for media attributes (Pro Plan+).
* Added a setting to enable advanced celebrity face recognition for media attributes (Premium Plan+).
* Added configurable meta tag fallback rules to reuse existing values when no generated data is available.
* Added a toggle to control JavaScript-based alt text injection separately from render-level injection.
* Added a troubleshooting toggle to pause database refresh operations during debugging.
* Added the “Active Meta Tags” setting to control which meta tags the plugin should generate.
* Added the “Active Post Types” setting to define which post types the plugin should process.
* Added a reminder and one-click removal option for previously generated SEO-relevant data within the SEO Autopilot modal.
* Added a “Generate Data for X Empty Fields” button in the Metadata and Media Attribute Editors.
* Added a “Save & edit next” button in the Metadata and Media Attribute Editors for faster sequential editing.
* Added a “Retry all failed” quick action to the Dashboard when failed entries are detected.
* Added Credits badges across the plugin UI to indicate the cost of generation actions.
* Added an “SEO-Expert Concierge” card to the Dashboard with direct contact options.
* Submit and Abort buttons are now sticky for easier access during editing.
* Bug Fixes & Maintenance: Fixed 21 minor bugs, implemented 29 usability improvements, implemented 35 stability improvements, and resolved 8 security issues.

= 2.1.0 =
* Added "Generate with SOOZ" buttons in the media section of the Gutenberg editor, allowing users to generate media attributes directly from the editor.
* Improved context awareness for pages, posts, and products, especially for content with short text. Ensures AI-generated metadata is more relevant and tailored.
* Added a setting for render-level alt text injection. This checkbox setting (enabled by default) ensures images always have the correct alt text, even if themes or other mechanisms fail to display it.
* Added a setting for render-level image title injection. Includes a select input to choose what should be injected as the title attribute: Disabled, Inject image title, Inject alt text (default), Inject caption, or Inject image description.
* Added a setting to the "SEO Autopilot" modal that allows users to customize the reference time used by the "Generate Metadata for" option. This gives more precise control over how new and old entries are distinguished.
* Added an "Export/Import" button to the plugin settings, enabling users to export their configuration and import it on another website. Useful for SEO and web agencies managing multiple sites.
* Added a "Restore Default" button to the plugin settings.
* Added a "Show/Hide Advanced Settings" toggle in the plugin settings. Some advanced settings are now hidden by default to simplify the interface for most users.
* Made setting descriptions more concise and user-friendly. Rearranged several settings for improved clarity and usability.
* Private or pending posts, pages, and attachments are now ignored by the plugin, preventing them from being processed.
* Improved UX: The SOOZ - AI for SEO sidebar is now sticky on desktop, keeping it visible during page scrolling for easier navigation.
* Changed how plugin notifications are handled. All notifications are now indicated by a red bubble in the admin menu. Detailed notices can be viewed in the SOOZ - AI for SEO dashboard.
* Added new notifications:
  - Insufficient credits balance.
  - Overview of missing entries to generate.
  - WPML plugin detected.
  - SEO Autopilot needing attention.
  - New major plugin updates.
  - Ongoing promos and discounts.
  - And others
* Bug Fixes & Maintenance: Fixed 17 minor bugs, added 6 quality-of-life improvements, implemented 3 performance optimizations, and 2 security updates.

= 2.0.0 =
* Complete UI/UX Overhaul: The look, feel, design, layout, and navigation of the plugin have been completely redesigned.
* Enhanced Mobile Experience: Improved usability and user experience for mobile users.
* New "Account" Page: Users can now manage their license key directly from this page.
* Incognito Mode: SEO and web agencies can hide the plugin from other users/admins (available in the new "Account" page).
* White-Label Feature: SEO and web agencies can rebrand the plugin with their own name or further hide it from other users/admins (available in the new "Account" page).
* Customizable Generator Hints: Added a setting to modify or disable generator hints in the source code for additional privacy (available in the "Account" page).
* Privacy & Data Policy Update: Moved to the new "Account" page.
* New Metadata Customization Options: Added settings to apply prefixes and suffixes to metadata and media attributes.
* Advanced Media Attribute Control: New setting allows users to specify which media attributes the plugin should use.
* "SEO Autopilot" Feature: Replaces bulk generation checkboxes with a more intuitive and easy-to-use interface, directly accessible from the dashboard.
* "Recent Activity" Dashboard Section: Track all manual and automatic metadata and media attribute generations in one place.
* Implemented new ways to get credits:
    * Introduced Credit Packs, allowing users to purchase additional credits as needed.
    * Added a Pay-As-You-Go option for automatic credit refills when running low.
    * All credit purchasing options are now combined in a "Get more Credits" modal, accessible from the dashboard.
* "Guarantee" Section: Review our Guarantees and Refund Policy directly on the dashboard.
* "Recent Plugin Updates" Section: Stay informed about the latest updates from the dashboard.
* New "Support & Feedback" Section: Easily access support and provide feedback directly from the dashboard.
* Tons more minor improvements, bug fixes, and performance enhancements.

= 1.2.0 =
* Image Metadata Generation: Added support for generating alt text, titles, captions, and descriptions for all images on your website.
* You can use the bulk or manual generation options available. Simply click the "Generate with SOOZ" button in the Media Library or explore the new "Media" page within the *SOOZ - AI for SEO* plugin.
* New "Settings" Page: We have introduced a "Settings" page with various options to enhance your experience (details below).
** Meta Tag Inclusion: This option allows you to include or exclude specific meta tags from being output in the header by our plugin. Note that this setting does not affect meta tags generated by other plugins. For instance, if you prefer the meta titles generated by another plugin, you may choose to exclude them here.
** Language Selection: Allows you to override the AI’s language detection, which is helpful if your content is in a language different from what the AI has detected.
** User Management: Controls which user roles can access and use the plugin. By default, only administrators have access.
** Improved Metadata Editor: We have overhauled the metadata editor’s design to enhance usability and provide a better user experience.
* General Enhancements: Implemented 12 minor bug fixes, performance improvements, and security updates.

= 1.1.0 =
* SEO data generation for WooCommerce products is now available. This feature is visible only if the WooCommerce plugin is installed, integrating SEO capabilities directly with your e-commerce activities.
* Introduced statistics in the dashboard page, providing users with insights into their progress in generating SEO metadata for pages, posts, products, and more. This feature aims to help users track their SEO optimization efforts more effectively.
* Added admin notices to alert users when their credits are running low or to remind them of the remaining credits and opportunities to generate SEO data for pages, posts, and products.
* Added a button to reestablish the license connection in the dashboard page, making it easier for users to reconnect their license if it has been disconnected. For example in case of uninstalling and reinstalling the plugin.
* All plugin texts are now translatable, making it easier for international users to optimize their SEO efforts.
* Refined some visual aspects of the dashboard page, improving the user interface and overall user experience.
* 11 Bug fixes and performance improvements.


== Upgrade Notice ==

= 2.3.0 =
We changed our branding from "AI for SEO" to "SOOZ - AI for SEO". Visit sooz.ai for more information.
This update also includes significant improvements to the quality of alt text and image attribute generation, performance optimizations, and various bug fixes.
We recommend updating to benefit from these enhancements.
Please note that this is a major update with significant changes, so we recommend backing up your website before proceeding with the update.
If you encounter any issues or have questions about the new features, please don't hesitate to contact our support team at [support@sooz.ai](mailto:support@sooz.ai).
