HarlemonLemonX Suite
Download Sign Up
Products
LemonX SuiteLemonX AEOLemonX CodeLemonX VertoLemonX MCPLemonX ProLemonX Theme
Solutions
SEO TeamsWordPress AgenciesEcommerce WebsitesMultilingual WebsitesGlobal B2B WebsitesDevelopersContent TeamsAI Agent WorkflowWebsite MigrationClient Reporting
Pricing
Pricing OverviewCompare PlansFree PlanPro PlanAgency PlanEnterpriseLifetime DealPricing FAQ
Compare
AEO vs YoastAEO vs Rank MathCode vs ElementorVerto vs WPMLVerto vs PolylangMCP vs REST APIAll comparisons
Resources
BlogAcademyDocsFAQChangelogRoadmapGlossaryTemplatesMigration GuidesPrompt LibrarySystem Requirements
Developers
Developer HomeMCP Tool ReferenceREST APIHooks & FiltersCloud GatewayAuthenticationWebhooksExamplesDeveloper Support
Support
Support CenterSubmit a TicketLicense HelpInstallation HelpAccount HelpBilling HelpCompatibilityTroubleshootingKnown IssuesSystem Status
Login Download Sign Up
Troubleshooting

Fix common LemonX issues faster.

Use this troubleshooting guide to diagnose common issues across LemonX AEO, Code, Verto, MCP, Pro and Theme. Start with the quick checks, then follow the product-specific steps for installation, license activation, AI provider setup, indexing, translation, MCP connection, compatibility and performance problems.

Start Quick Checks Submit a Ticket Check System Status
Step-by-step diagnosisProduct-specific fixesWordPress environment checksSafe troubleshooting workflow
Start Here

Run these quick checks first.

Many LemonX issues are caused by environment settings, outdated versions, cache, license status, API provider configuration or plugin conflicts. Before opening a ticket, complete these basic checks.

1

Confirm the product is installed and active

Go to: WordPress Dashboard > Plugins. Make sure the related LemonX plugin is installed and activated.

  • LemonX AEO
  • LemonX Code
  • LemonX Verto
  • LemonX MCP
  • LemonX Pro
  • LemonX Theme

If the product is missing, install it first.

Installation Help
2

Check plugin and theme versions

Make sure you are using the latest available version of the LemonX product.

  • Plugin version
  • Theme version
  • WordPress version
  • PHP version
  • Changelog notes
View Changelog
3

Confirm your license status

If you are using Pro features, make sure your license is active and connected to the correct site.

  • License key
  • License email
  • Site activation
  • Plan status
  • Product entitlements
  • Renewal status
License Help
4

Check system status

If license verification, cloud gateway, updates, AI requests, indexing or MCP services are not working, check the LemonX status page.

  • License Service
  • Cloud Gateway
  • Update Server
  • AI Gateway
  • Indexing Service
  • MCP Service
Check System Status
5

Clear cache

Caching can sometimes make changes appear broken or outdated.

  • Browser cache
  • WordPress cache
  • Server cache
  • CDN cache
  • Object cache
  • Page builder cache

Then test again in a private browser window.

6

Test with a small workflow

Before running a large workflow, test one small action.

Examples:

  • Analyze one page
  • Generate one draft
  • Translate one page
  • Submit one URL
  • Connect one MCP client
  • Activate one license
  • Run one AI request

If the small workflow works, the issue may be related to batch size, timeout, quota or server limits.

7

Review recent changes

Think about what changed before the issue appeared.

Examples:

  • LemonX update
  • WordPress update
  • Theme update
  • New plugin installed
  • Cache plugin changed
  • Security plugin changed
  • Hosting migration
  • PHP version changed
  • AI provider key changed
  • License renewal failed
8

Temporarily test for conflicts

On a staging site, temporarily disable non-essential plugins and switch to a default theme to test whether the issue is caused by a conflict.

Do not disable plugins on a production site unless you understand the impact. Use staging whenever possible.

Compatibility Help
Diagnosis Flow

Use this path to find the cause.

1

Identify the affected product

  • LemonX AEO
  • LemonX Code
  • LemonX Verto
  • LemonX MCP
  • LemonX Pro
  • LemonX Theme
  • Account or Billing
  • Full LemonX Suite
2

Identify the issue type

  • Installation
  • License
  • AI provider connection
  • Indexing
  • Translation
  • MCP connection
  • Page generation
  • Visual editor
  • Compatibility
  • Performance
  • Update
  • Account access
  • Billing
3

Check environment

  • WordPress version
  • PHP version
  • Active theme
  • Active plugins
  • SSL / HTTPS
  • REST API availability
  • Cron availability
  • Memory limit
  • Upload limit
  • Server logs
4

Try the smallest reproducible test

Instead of testing a full workflow, test one small action.

  • Generate one section instead of a full page
  • Translate one page instead of the whole site
  • Submit one URL instead of the whole sitemap
  • Enable MCP read tools before write tools
  • Test one AI model before multiple providers
5

Check logs and error messages

  • WordPress error logs
  • Browser console errors
  • LemonX logs
  • MCP logs
  • AI provider response errors
  • Server timeout messages
  • HTTP status codes
  • License verification errors
6

Apply the matching fix

Use the product-specific sections below.

7

Submit a ticket if unresolved

If the issue continues, submit a ticket with full details.

Submit a Ticket
Installation Issues

Plugin or theme installation problems

1. ZIP upload fails

Possible causes

  • Upload limit too low
  • ZIP file too large
  • ZIP file corrupted
  • Server timeout
  • Hosting security rule blocking upload
  • Wrong installation area

Try this

  1. Re-download the ZIP file.
  2. Confirm the file ends with .zip.
  3. Do not unzip before uploading through WordPress.
  4. Upload plugins from Plugins > Add New > Upload Plugin.
  5. Upload themes from Appearance > Themes > Add New > Upload Theme.
  6. Increase upload limit if needed.
  7. Try SFTP installation.
  8. Contact hosting if the server blocks uploads.

Related page: Installation Help

2. WordPress says the package cannot be installed

Possible causes

  • Plugin ZIP uploaded as a theme
  • Theme ZIP uploaded as a plugin
  • ZIP contains an extra nested folder
  • ZIP is incomplete
  • Incorrect product package
  • File permissions issue

Try this

  1. Confirm whether the file is a plugin or theme.
  2. Re-download from the official download page.
  3. Upload to the correct WordPress section.
  4. Try installing through SFTP.
  5. Check file permissions.
  6. Submit a ticket if it still fails.

3. Plugin activates but no menu appears

Possible causes

  • User role is not Administrator
  • Browser cache
  • Admin JavaScript error
  • Plugin conflict
  • Incomplete activation
  • License required for menu access
  • Product module disabled

Try this

  1. Log in as Administrator.
  2. Refresh the dashboard.
  3. Clear browser cache.
  4. Disable admin cache plugins temporarily.
  5. Check browser console.
  6. Check plugin status.
  7. Check license status.
  8. Submit a ticket with screenshots.
License Issues

License activation or Pro access problems

1. License key does not activate

Possible causes

  • Incorrect license key
  • Extra spaces copied
  • License expired
  • Wrong account email
  • Site limit reached
  • License service unavailable
  • Server cannot connect to LemonX
  • Firewall blocks outbound requests

Try this

  1. Copy the license key again.
  2. Remove extra spaces.
  3. Confirm the license email.
  4. Check plan status.
  5. Check site activation limit.
  6. Deactivate unused sites if needed.
  7. Check System Status.
  8. Ask hosting whether outbound HTTPS requests are blocked.
  9. Submit a license ticket if unresolved.

Related page: License Help

2. Pro features are not unlocked

Possible causes

  • LemonX Pro not installed
  • License not active
  • Product not included in plan
  • Entitlements not refreshed
  • Cache issue
  • Site not connected to license
  • Subscription expired

Try this

  1. Confirm LemonX Pro is active.
  2. Check license status.
  3. Refresh product entitlements.
  4. Clear cache.
  5. Reconnect license if needed.
  6. Check whether your plan includes the feature.
  7. Submit a ticket with plan name and product name.

3. Site activation limit reached

Possible causes

  • Too many sites activated
  • Staging and production both counted
  • Old client sites still connected
  • Development sites not removed

Try this

  1. Log in to your LemonX account.
  2. Open My Licenses.
  3. Review active sites.
  4. Deactivate unused sites.
  5. Try activating again.
  6. Upgrade plan if you need more sites.
Manage Licenses
AI Provider Issues

AI requests, model connection or provider errors

1. AI provider connection failed

Possible causes

  • Invalid API key
  • Wrong endpoint
  • Incorrect model name
  • Provider account has no balance
  • Provider rate limit reached
  • Provider service unavailable
  • Server firewall blocks requests
  • SSL issue

Try this

  1. Re-enter the API key.
  2. Check the provider endpoint.
  3. Confirm the model name.
  4. Check provider account balance.
  5. Check rate limits.
  6. Test a different model.
  7. Test another provider.
  8. Check server outbound request settings.
  9. Submit a ticket with the provider name and error message.

2. AI generation returns poor results

Possible causes

  • Prompt too vague
  • No knowledge base connected
  • Missing product context
  • Wrong model selected
  • Low-quality source material
  • Output length too short
  • Temperature or model settings not suitable

Try this

  1. Add more context to the prompt.
  2. Connect a knowledge base.
  3. Upload product documents.
  4. Use a stronger model.
  5. Add brand tone and target audience.
  6. Ask for structured output.
  7. Generate smaller sections first.
  8. Review and refine.

3. AI request times out

Possible causes

  • Prompt too long
  • Large document attached
  • Slow provider response
  • Server timeout limit
  • Low memory limit
  • Network interruption
  • Large page generation task

Try this

  1. Reduce prompt size.
  2. Generate one section at a time.
  3. Use a faster model.
  4. Increase server timeout if possible.
  5. Increase PHP memory limit.
  6. Retry later.
  7. Check provider status.

4. AI provider says quota or rate limit exceeded

Possible causes

  • Provider plan limit reached
  • Too many requests in short time
  • Translation batch too large
  • Content generation queue too aggressive
  • Shared API key used across multiple sites

Try this

  1. Check provider usage dashboard.
  2. Wait for rate limit reset.
  3. Reduce batch size.
  4. Use queue throttling.
  5. Add backup provider.
  6. Upgrade provider plan if needed.
LemonX AEO

AEO, SEO, indexing and search visibility issues

1. Google Search Console connection fails

Possible causes

  • Incorrect Google account
  • Missing site property
  • Permission not granted
  • OAuth connection expired
  • API access restricted
  • Browser blocked authorization popup

Try this

  1. Confirm you are using the correct Google account.
  2. Check that the site property exists in Search Console.
  3. Confirm owner or full user permission.
  4. Reconnect Google account.
  5. Disable popup blockers temporarily.
  6. Try another browser.
  7. Submit a ticket with the exact error.

2. Google Indexing API does not work

Possible causes

  • API not enabled
  • Service account not configured
  • Wrong JSON key
  • Missing property permissions
  • Unsupported content type
  • API quota reached
  • URL not eligible

Try this

  1. Check Google Indexing API setup.
  2. Confirm API is enabled.
  3. Verify service account permissions.
  4. Check JSON credentials.
  5. Test one URL.
  6. Check API quota.
  7. Confirm URL type is supported.
  8. Review AEO indexing docs.
Indexing Docs
WhatsApp+44 7724 592551