HarlemonLemonX Suite
Download Get Started Free
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 Get Started Free
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

3. Schema markup is missing

Possible causes

  • Schema module disabled
  • Content type not supported
  • Cache serving old HTML
  • Theme conflict
  • SEO plugin conflict
  • Incorrect settings
  • Page excluded from Schema

Try this

  1. Confirm Schema module is enabled.
  2. Check Schema settings.
  3. Clear cache.
  4. Test page source.
  5. Use a structured data testing tool.
  6. Check SEO plugin overlap.
  7. Test with a default theme on staging.

4. Sitemap is not updating

Possible causes

  • Sitemap module disabled
  • Cache issue
  • Permalink issue
  • Content excluded
  • Cron not running
  • Conflict with another sitemap plugin

Try this

  1. Save permalink settings.
  2. Clear cache.
  3. Confirm sitemap module is enabled.
  4. Check excluded post types.
  5. Disable duplicate sitemap sources on staging.
  6. Regenerate sitemap if available.

5. Rank tracking data is missing

Possible causes

  • Tracking not configured
  • Keywords not added
  • Region or device not selected
  • API limit reached
  • Scheduled task not running
  • New keyword has not been checked yet

Try this

  1. Add target keywords.
  2. Confirm location and device settings.
  3. Check schedule.
  4. Check quota or usage limit.
  5. Wait for next update.
  6. Submit a ticket if data stays empty.

6. AI citation tracking shows no data

Possible causes

  • No queries configured
  • Brand name not added
  • Topic too broad
  • AI provider not connected
  • Tracking schedule not completed
  • Website not yet visible in AI answers

Try this

  1. Add brand name.
  2. Add target topics.
  3. Add realistic AI questions.
  4. Run a manual test if available.
  5. Check provider connection.
  6. Wait for scheduled tracking.
  7. Improve content structure and authority signals.
LemonX Code

AI page generation, visual editor and knowledge base issues

1. Page generation failed

Possible causes

  • AI provider not connected
  • Prompt too long
  • Model error
  • Server timeout
  • Memory limit too low
  • Invalid output format
  • Plugin conflict

Try this

  1. Check AI provider connection.
  2. Generate a smaller section first.
  3. Use a shorter prompt.
  4. Try another model.
  5. Increase memory or timeout if possible.
  6. Check browser console.
  7. Disable conflicting plugins on staging.
  8. Submit a ticket with error message.

2. Visual editor does not load

Possible causes

  • JavaScript error
  • Admin cache issue
  • Security plugin blocking scripts
  • Theme conflict
  • Browser extension conflict
  • REST API blocked
  • User permission issue

Try this

  1. Refresh the page.
  2. Clear browser cache.
  3. Try incognito mode.
  4. Disable browser extensions temporarily.
  5. Check REST API.
  6. Check browser console.
  7. Test on staging with fewer plugins.
  8. Confirm user role permissions.

3. Knowledge base upload fails

Possible causes

  • File type unsupported
  • File too large
  • Upload limit too low
  • OCR processing failed
  • Server timeout
  • Memory limit too low
  • Permission issue

Try this

  1. Check supported file types.
  2. Upload a smaller file.
  3. Increase upload limit.
  4. Try PDF or plain text format.
  5. Check OCR settings.
  6. Check server logs.
  7. Upload one file at a time.

4. OCR does not recognize text

Possible causes

  • Image quality too low
  • Scanned file is blurry
  • Language not supported
  • PDF is image-heavy
  • File too large
  • OCR service error

Try this

  1. Upload a clearer file.
  2. Use a higher-resolution scan.
  3. Split large PDF files.
  4. Try a single page first.
  5. Check OCR settings.
  6. Manually add important text if needed.

5. Template does not apply correctly

Possible causes

  • Theme conflict
  • Missing CSS
  • Page builder conflict
  • Template version mismatch
  • Required module disabled
  • Custom CSS overriding layout

Try this

  1. Use LemonX Theme or a compatible theme.
  2. Clear cache.
  3. Check template requirements.
  4. Disable conflicting page builder output on staging.
  5. Reapply the template.
  6. Check frontend and mobile views.
LemonX Verto

Translation, multilingual SEO and queue issues

1. Translation queue is stuck

Possible causes

  • WP-Cron not running
  • Server cron not configured
  • AI provider failed
  • Queue batch too large
  • Server timeout
  • Cache conflict
  • Translation provider quota reached

Try this

  1. Check cron status.
  2. Test one translation manually.
  3. Reduce batch size.
  4. Check AI provider connection.
  5. Check provider quota.
  6. Disable aggressive cache temporarily.
  7. Check error logs.
  8. Submit a ticket with queue status.

2. Translated page is missing

Possible causes

  • Translation not completed
  • Language not enabled
  • Content type excluded
  • Queue failed
  • Permission issue
  • Cache showing old version

Try this

  1. Check language settings.
  2. Check translation queue.
  3. Confirm content type is enabled.
  4. Clear cache.
  5. Re-run translation.
  6. Check if the page is saved as draft.

3. URL or slug translation is wrong

Possible causes

  • Slug translation disabled
  • Glossary not configured
  • Manual override missing
  • Duplicate slug conflict
  • Language settings incorrect

Try this

  1. Enable URL and slug translation.
  2. Add glossary terms.
  3. Manually edit important slugs.
  4. Check duplicate URL conflicts.
  5. Regenerate permalink if needed.
  6. Clear cache.

4. hreflang is missing or incorrect

Possible causes

  • Language mapping incorrect
  • Page not translated
  • Canonical conflict
  • SEO plugin conflict
  • Cache issue
  • Multilingual settings incomplete

Try this

  1. Check language settings.
  2. Confirm translated pages exist.
  3. Check canonical settings.
  4. Clear cache.
  5. Check SEO plugin output.
  6. Validate hreflang output.

5. Language switcher is not showing

Possible causes

  • Switcher disabled
  • Theme location missing
  • Widget not added
  • Menu item not configured
  • Cache issue
  • CSS hidden by theme

Try this

  1. Enable language switcher.
  2. Add it to menu, widget or shortcode area.
  3. Clear cache.
  4. Test with a default theme on staging.
  5. Check CSS display rules.
  6. Confirm languages are active.
LemonX MCP

Claude, Codex, Cursor and MCP connection issues

1. MCP client cannot connect

Possible causes

  • Wrong endpoint URL
  • HTTPS not enabled
  • Authentication failed
  • Application password invalid
  • MCP plugin not active
  • Security plugin blocking request
  • REST API blocked
  • Site identity mismatch

Try this

  1. Confirm LemonX MCP is active.
  2. Copy endpoint URL again.
  3. Confirm HTTPS works.
  4. Regenerate credentials.
  5. Check authentication method.
  6. Disable blocking security rules on staging.
  7. Confirm REST API access.
  8. Check MCP logs.
MCP Setup Docs

2. MCP tools are not visible

Possible causes

  • Tools disabled
  • User role lacks permission
  • MCP client cache
  • Authentication issue
  • Product module disabled
  • Site not verified

Try this

  1. Enable required MCP tools.
  2. Check user role permissions.
  3. Refresh MCP client.
  4. Reconnect client.
  5. Verify site identity.
  6. Check product module status.
  7. Review MCP logs.

3. AI can read but cannot write

Possible causes

  • Write tools disabled
  • User role lacks permission
  • Preview to Apply required
  • Security settings block writes
  • Content type not allowed
  • Application password has limited permissions

Try this

  1. Enable write tools only if needed.
  2. Review permission settings.
  3. Use Preview to Apply.
  4. Confirm content type access.
  5. Check user role.
  6. Review logs.
  7. Avoid enabling broad write access unnecessarily.

4. Preview to Apply does not work

Possible causes

  • Preview module disabled
  • JavaScript error
  • REST API blocked
  • Permission issue
  • Content type unsupported
  • Client request format invalid

Try this

  1. Confirm Preview to Apply is enabled.
  2. Check browser console.
  3. Check REST API.
  4. Verify permissions.
  5. Test with a simple post update.
  6. Review MCP logs.
  7. Submit ticket with request details.

5. Site identity mismatch

Possible causes

  • Wrong site connected
  • Staging and production mixed
  • Site URL changed
  • Domain migration
  • Cached MCP configuration
  • Old credentials used

Try this

  1. Confirm current site URL.
  2. Regenerate credentials.
  3. Update MCP client configuration.
  4. Remove old site connection.
  5. Verify site identity again.
  6. Check whether staging and production use different credentials.
Compatibility

Theme, plugin and hosting conflicts

1. LemonX conflicts with another plugin

Common conflict areas

  • SEO plugins
  • Translation plugins
  • Page builders
  • Cache plugins
  • Security plugins
  • REST API blockers
  • WooCommerce extensions
  • Custom admin plugins

Try this on staging

  1. Disable non-essential plugins.
  2. Test LemonX again.
  3. Re-enable plugins one by one.
  4. Identify the conflicting plugin.
  5. Check plugin settings.
  6. Submit a ticket with the conflict details.

Related page: Compatibility Help

2. Cache plugin causes outdated output

Possible symptoms

  • Translations not showing
  • Schema not updating
  • CSS not loading
  • Language switcher missing
  • Generated page shows old content
  • Frontend and admin look different

Try this

  1. Clear cache.
  2. Disable minification temporarily.
  3. Disable JavaScript delay temporarily.
  4. Exclude LemonX admin routes if needed.
  5. Clear CDN cache.
  6. Test in incognito mode.

3. Security plugin blocks LemonX requests

Possible symptoms

  • MCP cannot connect
  • REST API blocked
  • License verification fails
  • AI provider request fails
  • Indexing request blocked
  • Admin action fails

Try this

  1. Check firewall logs.
  2. Allow LemonX REST endpoints.
  3. Allow outbound HTTPS requests.
  4. Allow MCP endpoint if enabled.
  5. Temporarily test with strict rules disabled on staging.
  6. Avoid weakening production security without understanding the impact.

4. Hosting environment blocks background tasks

Possible symptoms

  • Translation queue stuck
  • Indexing queue delayed
  • Reports not generated
  • AI batch tasks incomplete
  • Scheduled checks missing

Try this

  1. Check WP-Cron.
  2. Set real server cron if possible.
  3. Increase memory limit.
  4. Increase timeout.
  5. Reduce batch size.
  6. Ask hosting provider about background task limits.
Performance

Site slow, admin slow or tasks taking too long

1. WordPress admin becomes slow

Possible causes

  • Large batch operation running
  • Too many modules enabled
  • Translation queue processing
  • AI generation task running
  • Low memory limit
  • Object cache issue
  • Heavy plugin conflict

Try this

  1. Pause large tasks.
  2. Disable unused modules.
  3. Reduce batch size.
  4. Check server memory.
  5. Clear cache.
  6. Check active background tasks.
  7. Review server logs.

2. Frontend becomes slow

Possible causes

  • Cache disabled
  • Large generated page
  • Heavy media files
  • Too much custom CSS or JS
  • Translation switcher conflict
  • Theme conflict
  • Multiple SEO or translation plugins outputting duplicate data

Try this

  1. Clear and enable cache.
  2. Optimize images.
  3. Check generated page size.
  4. Disable duplicate plugin outputs.
  5. Test with a compatible theme.
  6. Review frontend scripts.
  7. Use performance tools.

3. Batch tasks take too long

Possible causes

  • Batch size too large
  • AI provider slow
  • Provider rate limit
  • Server timeout
  • Cron delay
  • Large content volume
  • Low hosting resources

Try this

  1. Reduce batch size.
  2. Process in smaller groups.
  3. Use a faster model.
  4. Enable provider backup if available.
  5. Check cron.
  6. Increase server resources.
  7. Run heavy tasks during low-traffic hours.
Updates

Problems after updating LemonX

1. Feature stopped working after update

Possible causes

  • Cache still serving old assets
  • Product settings need refresh
  • Database migration incomplete
  • Plugin conflict after update
  • Old Pro version with new product version
  • Browser cache issue

Try this

  1. Clear all caches.
  2. Check if all LemonX products are updated.
  3. Update LemonX Pro first if used.
  4. Refresh license entitlements.
  5. Check changelog.
  6. Test on staging.
  7. Submit ticket with before/after versions.

2. Update failed

Possible causes

  • License inactive
  • Update server unavailable
  • File permission issue
  • Server timeout
  • Disk space issue
  • Connection blocked

Try this

  1. Check license status.
  2. Check system status.
  3. Try again later.
  4. Check file permissions.
  5. Check available disk space.
  6. Update manually from ZIP if needed.

3. White screen or fatal error after update

Possible causes

  • PHP version incompatibility
  • Plugin conflict
  • Incomplete update
  • Memory limit exhausted
  • Theme conflict
  • Custom code conflict

Try this

  1. Do not repeatedly refresh production pages.
  2. Access recovery mode if WordPress sends a recovery email.
  3. Disable the affected plugin via SFTP if needed.
  4. Restore backup if required.
  5. Check PHP error logs.
  6. Submit urgent ticket with logs and versions.
Error Messages

Common error types and what they usually mean

Unauthorized — Authentication failed

Check:

  • License key
  • API key
  • MCP credentials
  • User permission
  • Application password
  • Expired token

Forbidden — Access is blocked

Check:

  • User role
  • Security plugin
  • Firewall
  • Server rules
  • REST API restrictions
  • MCP tool permissions

Not Found — Route is missing

Check:

  • Permalinks
  • REST API route
  • MCP endpoint
  • Site URL
  • Plugin activation
  • Rewrite rules

Request Timeout — Request took too long

Check:

  • Prompt length
  • Batch size
  • Server timeout
  • AI provider response speed
  • Network stability

Too Many Requests — Rate limit reached

Check:

  • AI provider quota
  • API rate limits
  • Batch size
  • Queue throttling
  • Shared API key usage

Server Error — Server-side error

Check:

  • PHP error logs
  • Memory limit
  • Plugin conflict
  • Fatal error
  • File permissions
  • Hosting logs

cURL Error — External request failed

Check:

  • Hosting firewall
  • SSL certificate
  • DNS
  • Outbound HTTPS access
  • Provider endpoint
  • Server network settings

Invalid API Key — Credentials wrong or inactive

Check:

  • API key value
  • Provider account status
  • Billing balance
  • Model access
  • Key permissions
Safe Troubleshooting

Troubleshoot without breaking your site.

Rule 1: Use staging when possible

Test major changes on a staging site before production.

Rule 2: Back up first

Before large updates, migrations, batch translations or MCP write actions, create a backup.

Rule 3: Change one thing at a time

Do not disable many plugins, change themes and update PHP all at once. Make one change, test, then continue.

Rule 4: Keep notes

Write down what you changed and what happened. This helps you reverse changes and helps support diagnose faster.

Rule 5: Avoid sharing secrets

Do not paste private API keys, passwords, database credentials or full license keys into public tickets or screenshots.

Rule 6: Start small

Use one draft page, one URL, one translation or one MCP tool before running large workflows.

Rule 7: Review permissions

Be careful with MCP write tools. Enable only the tools you need and use Preview to Apply whenever possible.

Need More Help?

What to include when submitting a troubleshooting ticket

If the issue continues, send us clear details so we can help faster.

1

Product name

AEO, Code, Verto, MCP, Pro, Theme or Suite.

2

Product version

Include plugin or theme version.

3

WordPress version

Include your WordPress version.

4

PHP version

Include your PHP version.

5

Active theme

Tell us which theme is active.

6

Related plugins

List SEO, translation, page builder, cache, security and WooCommerce plugins.

7

Exact error message

Copy the full message if available.

8

Screenshot or screen recording

Remove private data before uploading.

9

Steps to reproduce

Write the exact steps that trigger the issue.

10

Expected result

Tell us what you expected to happen.

11

Actual result

Tell us what happened instead.

12

Recent changes

Mention updates, plugin installs, theme changes, hosting changes or API key changes.

Submit Troubleshooting Ticket
Troubleshooting FAQ

Frequently asked troubleshooting questions

Where should I start if I do not know what is wrong?

Start with the quick checks: confirm product activation, update versions, check license status, clear cache, check system status and test one small workflow.

Should I troubleshoot on my live site?

For small checks, it may be okay. For major changes, plugin conflict tests, theme switching, MCP write tools, migration or large translation batches, use a staging site.

How do I know if the issue is caused by LemonX or another plugin?

Test on staging by disabling non-essential plugins, then re-enable them one by one. If the issue appears only when another plugin is active, it may be a conflict.

What should I do if I see a fatal error?

Do not repeatedly refresh the page. Check your email for WordPress recovery mode, disable the affected plugin via SFTP if needed, review PHP error logs and submit a ticket.

Why does AI generation fail sometimes?

Common reasons include invalid API key, provider quota, rate limit, timeout, long prompt, slow model response or server memory limits.

Why is my translation queue stuck?

Common reasons include cron issues, provider quota, queue batch size, server timeout, cache conflict or translation provider error.

Why does MCP fail to connect?

Common reasons include wrong endpoint, authentication issue, SSL problem, REST API block, security plugin rules or site identity mismatch.

Why are changes not visible on the frontend?

Clear cache first. Then check CDN cache, page cache, browser cache, theme template output and whether the content was saved as draft.

Should I send support my API key?

No. Never send private API keys, passwords, hosting credentials or database credentials in plain text.

What information helps support most?

Product name, version, WordPress version, PHP version, active theme, related plugins, exact error message, screenshots, steps to reproduce and recent changes.

Still stuck?

Send us the product name, version, WordPress environment, exact error message and steps to reproduce. We will help you find the next step.

Submit Troubleshooting Ticket Back to Support Center Check System Status

Please remove private data from screenshots and never include passwords, private API keys, hosting credentials or payment information in your ticket.