Payo SEO Suite Pro Documentation
Official client guide for installing, activating and using Payo SEO Suite Pro, a professional Joomla SEO extension for metadata, AI-assisted on-page optimization, sitemaps, structured data, redirects, 404 monitoring and HikaShop SEO workflows.
1. Overview
Payo SEO Suite Pro helps Joomla website owners, agencies and store administrators manage important SEO tasks from one focused administrator interface. It is designed for real Joomla websites where SEO work often involves metadata, product pages, structured data, old URLs, 404 logs, image ALT data and sitemap management.
Manage SEO titles, descriptions and social metadata.
Generate improved page structures with controlled AI-assisted workflows.
Create main, image and video sitemap files.
Generate cleaner schema for pages, breadcrumbs and products.
Monitor broken URLs and prepare redirect decisions.
Improve product SEO, product images, ALT data and Product schema.
2. Requirements
| Requirement | Recommended |
|---|---|
| CMS | Joomla 5.x. The extension is built with modern Joomla architecture and prepared for future compatibility where supported by Joomla APIs. |
| PHP | PHP 8.1 or newer is recommended. PHP 8.3 can be used when your Joomla website and hosting environment support it. |
| Database | MySQL or MariaDB versions supported by Joomla. |
| Optional store support | HikaShop is optional. HikaShop features are available only when HikaShop is installed and used. |
| AI features | A compatible AI API key is required for AI-powered features. |
| License | A valid Payo SEO Suite Pro license key is required for premium features, support and updates. |
3. Installation
- Log in to your Joomla administrator area.
- Go to System → Install → Extensions.
- Upload the installable Payo SEO Suite Pro ZIP package.
- Wait until Joomla confirms that the installation is complete.
- Go to Components → Payo SEO Suite Pro.
- Open License & Updates and activate your license key.
Install only the official package received after purchase. Do not rename or modify extension files before installation unless instructed by Payo Themes support.
4. License Activation
After installation, open License & Updates and enter your license key. The extension will securely verify the license with the Payo Themes license server and register the current website domain according to your license plan.
What you should see after activation
- License status: Active, Invalid, Expired or Revoked
- License plan
- Activated domain
- Activation usage
- Updates availability
- Support availability
- Expiry date, when applicable
Common license messages
| Message | What it means |
|---|---|
| Invalid license key. Please check the code and try again. | The key is incorrect, does not belong to this product, or was rejected by the license server. |
| Could not connect to the license server. Please try again later. | Your website could not contact the license server. This may be caused by hosting firewall, temporary connection issues or disabled outgoing requests. |
| Activation limit reached. | Your license has already been activated on the maximum number of websites allowed by your plan. |
Your full license key is not displayed publicly on the website frontend. Keep your license key private and do not share it with other users.
5. Dashboard
The dashboard provides a quick overview of the SEO environment and links to the main tools.
- SEO status overview
- Shortcut cards for major tools
- License status summary
- Important notices and system warnings
6. General Settings
The settings area controls the main behavior of the extension. Available options can vary depending on the installed version and active modules.
Recommended setup
- Activate your license first.
- Configure general SEO options.
- Configure AI options only if you plan to use AI-powered features.
- Generate sitemap files after confirming that your published content is correct.
- Review audit results before applying bulk changes.
Before using large batch actions on a live site, create a full website backup from your hosting panel or backup extension.
7. SEO Meta
SEO Meta tools help manage SEO titles, meta descriptions and social metadata for your Joomla pages.
Main capabilities
- SEO title management
- Meta description management
- Open Graph metadata
- Quick SEO editing workflow
- AI-assisted meta generation when configured
Recommended usage
- Scan or open the SEO Meta area.
- Review pages with missing or weak metadata.
- Generate or manually write better SEO titles and descriptions.
- Save changes.
- Run SEO Audit again if issues remain visible.
8. AI On-Page SEO
AI On-Page SEO is designed to improve weak page content while preserving important details, images and technical data. It can help create better structured HTML content with headings, paragraphs, lists and more complete page copy.
Workflow
- Open the On-Page SEO area.
- Start a fresh scan.
- Review the detected issues.
- Use AI generation for visible pages that need improvement.
- Review the generated result when available.
- Apply the result only when it is suitable for the page.
Safeguards
- Existing images should be preserved.
- Default or placeholder images are ignored where possible.
- Weak or empty AI output is blocked by quality checks.
- Backups are created before applying AI-generated content.
AI-generated content should always be reviewed by the website administrator, especially for commercial, legal, medical, financial or technical claims.
9. SEO Audit
SEO Audit detects common SEO problems and helps you understand which pages require attention.
| Issue | Recommended action |
|---|---|
| Missing meta description | Use Fix SEO, add a good meta description, save it, then run Recheck Audit. |
| 404 URL logged | Review the URL and create a redirect only if the old URL should lead to a valid page. |
| Product schema missing price | Use a valid product price or allow the extension to avoid incomplete Offer schema for request-price products. |
| Thin content | Improve the page content manually or with AI assistance, then scan again. |
10. Sitemaps
Payo SEO Suite Pro can generate dedicated sitemap files for search engines.
Available sitemap files
payo-sitemap.xml— main sitemappayo-sitemap-images.xml— image sitemappayo-video-sitemap.xml— video sitemap
Recommended usage
- Make sure your important pages/products are published.
- Generate or refresh the sitemap files.
- Open each sitemap URL in the browser to verify it loads.
- Submit the sitemap URLs in Google Search Console.
Sitemaps should include active, relevant URLs. Old 404 URLs should not be added to the sitemap.
11. Structured Data
Structured data helps search engines understand your website, organization, breadcrumbs and products.
Supported schema areas
- Organization schema
- Website schema
- BreadcrumbList schema
- Product schema
- Product Offer validation
Product price rule
If a HikaShop product has a valid price greater than 0, Product schema can include offers.price.
If the product has no real price or is request-price only, the extension avoids generating incomplete Offer data.
After fixing structured data, test the public URL with Google Rich Results Test and then validate the fix in Google Search Console.
12. Redirects & 404 Monitor
The 404 monitor records real requests for missing URLs. These logs are useful for finding old URLs, broken links, bot requests or URLs that still exist in Google Search Console.
Recommended workflow
- Review the most important or most repeated 404 URLs.
- Create redirects only for URLs that have a relevant destination.
- Do not redirect every 404 to the homepage automatically.
- Clear logs after important redirects are configured.
- Check again later to see if new 404 requests appear.
Deleting 404 logs only clears the extension log. If Google, users or bots request the same old URLs again, they may be logged again.
13. HikaShop SEO
Payo SEO Suite Pro includes HikaShop-aware SEO tools for Joomla websites that use HikaShop.
Supported HikaShop workflows
- Published product source filtering
- Product meta optimization
- Product description AI repair
- Product image ALT checks
- Default barcode / placeholder image filtering
- Product schema and Offer validation
HikaShop features are available only when HikaShop is installed and the products are published and accessible.
14. Updates
When your license is active and updates are enabled for your plan, Joomla can check for Payo SEO Suite Pro updates through the configured Payo Themes update server.
Recommended update steps
- Create a full website backup.
- Check that your license is active.
- Use Joomla's update system or install the latest official package manually.
- Clear Joomla cache after updating.
- Open the extension dashboard and confirm the version number.
15. Security Notes
- Keep Joomla, PHP and all installed extensions updated.
- Use HTTPS on production websites.
- Use strong administrator passwords.
- Enable two-factor authentication for administrator accounts where possible.
- Do not share your license key publicly.
- Install only official extension packages received from Payo Themes or the official sales channel.
- Back up your website before large batch SEO operations.
- Review AI-generated content before using it on important pages.
No extension can guarantee complete protection against every possible attack. Keep the full Joomla environment, hosting account and administrator access secure.
16. Getting Support
If you experience a problem, collect the most relevant information before contacting support. This helps the support team understand and reproduce the issue faster.
Before contacting support
- Check that you are using the latest available version of Payo SEO Suite Pro.
- Confirm that your license is active.
- Clear Joomla cache and browser cache.
- Check whether the issue also happens with third-party optimization/cache plugins disabled.
- Take screenshots of the issue.
- Copy the exact error message if one appears.
Useful details to include
- Your Joomla version
- Your PHP version
- Payo SEO Suite Pro version
- Whether HikaShop is installed
- The affected page URL, if the issue is public
- Screenshots or a short screen recording
- Steps needed to reproduce the problem
Do not send administrator passwords in plain text. If temporary access is required, create a temporary admin account and remove it after the support session is completed.
17. Troubleshooting
Invalid license key
Check that the license key is copied correctly, belongs to Payo SEO Suite Pro, is not expired and has not been revoked.
Could not connect to the license server
Your website may not be able to make outgoing HTTPS requests. Ask your hosting provider to check firewall rules, cURL support and outgoing connections.
Activation limit reached
Your license has already been activated on the maximum number of websites allowed by your plan. If you changed domains or staging websites, contact support.
Google still shows old schema errors
Google may need time to recrawl your page. Test the live URL with Google Rich Results Test, then validate the fix in Google Search Console.
On-Page AI processed 0 items
Make sure the visible rows contain real repairable issues and that the latest admin JavaScript is loaded after clearing Joomla cache.
Sitemap does not update
Clear Joomla cache, regenerate the sitemap and open the sitemap URL in a private browser window.
18. License Terms
Your Payo SEO Suite Pro license allows you to install and use the extension according to the plan you purchased. The activation limit depends on your license plan.
Important restrictions
- You are not allowed to resell, redistribute, share, publish or repackage the extension.
- You are not allowed to provide the extension ZIP file as a download to other people.
- You are not allowed to include the extension in another commercial package without written permission from Payo Themes.
- You must keep your license key private.
- You may use the extension only on the number of websites allowed by your license plan.
Sharing or reselling the extension without permission may result in license revocation and loss of access to updates and support.
19. FAQ
Do AI features require an API key?
Yes. AI-powered features require a compatible AI API key configured by the website administrator. Without an API key, the standard SEO tools, audit, sitemaps, redirects and manual optimization features can still be used.
Can I use Payo SEO Suite Pro without HikaShop?
Yes. HikaShop support is optional. Payo SEO Suite Pro can optimize Joomla articles, pages, metadata, sitemaps, redirects and structured data even if HikaShop is not installed.
Does the extension automatically change my website content?
No. AI-assisted changes are controlled from the administrator area. The extension can generate SEO suggestions and improved content, but the administrator decides when to apply them.
Does Payo SEO Suite Pro create backups before applying AI content?
Yes. The extension is designed to create backups before applying AI-generated page content, so the administrator has a safer workflow when editing important pages.
Can I use it on more than one website?
That depends on the license plan you purchased. A 1-site license can be activated on one Joomla website, while multi-site licenses allow more activations according to the purchased plan.
Am I allowed to resell or redistribute the extension?
No. You are not allowed to resell, redistribute, share, publish, repackage or provide the extension ZIP file to other people. The license is for use according to your purchased plan, not for resale or redistribution.
Can I include Payo SEO Suite Pro in a client website project?
Yes, if your license plan allows activation on that website. However, you may not give the extension package or license key to the client for redistribution or resale.
What happens if my license expires?
If your license expires, access to updates and support may be limited depending on your license plan. Active updates, support and license-based services require a valid license.
Can I update the extension from Joomla?
Yes, when your license allows updates and the update server is available, Payo SEO Suite Pro can receive updates through the Joomla update system.
Does it support product structured data?
Yes. Payo SEO Suite Pro includes Product schema support for HikaShop product pages. When a valid product price exists, the extension can include offer price data. If no real price exists, it avoids generating incomplete offer data.
Does it generate XML sitemaps?
Yes. The extension can generate a main sitemap, an image sitemap and a video sitemap, depending on the content detected on your Joomla website.
Can it fix 404 errors automatically?
The extension can detect and log 404 URLs, but the administrator should review them and create redirects to the most relevant valid pages. This avoids redirecting old URLs to incorrect destinations.
Is it safe to use AI on product pages?
Yes, but AI-generated content should always be reviewed before or after applying it. The extension includes safeguards, but the website administrator remains responsible for checking accuracy, product details and commercial claims.
What should I do if I have a problem?
First, clear Joomla cache, check your license status, confirm your extension version and try to reproduce the issue. If the issue remains, contact support with your Joomla version, PHP version, extension version, screenshots, the affected URL and the exact steps needed to reproduce the problem.
Should I send my administrator password to support?
No. Do not send administrator passwords in plain text. If temporary access is required, create a temporary administrator account and remove it after the support session is completed.
Where can I find the documentation?
The documentation is available online from the official product documentation page provided by Payo Themes. It includes installation, license activation, feature usage and troubleshooting instructions.