Troubleshoot AI Webmaster Studio Setup, API, Content and Link Issues
AI Webmaster Studio is a free WordPress plugin that helps website owners build, expand and manage WordPress websites with AI-assisted content, structure, documentation and site management workflows under administrator supervision.
Use this guide when AI Webmaster Studio does not behave as expected. Common causes include an unsaved or invalid API key, provider account limits, WordPress permissions, server restrictions, plugin conflicts, content review settings, request timeouts, incorrect internal links and mismatched page or menu destinations.
Before changing important live content, verify the configuration with a small, reversible task and review the result before continuing. Keep a recent backup and confirm the intended page, slug and internal links before approving changes.
Before You Begin: Basic Checks
Check the basics first:
- WordPress, the active theme and relevant plugins are maintained and compatible.
- Your active theme is working correctly.
- AI Webmaster Studio is installed and activated.
- You are logged in as a WordPress administrator.
- Your own provider API key is configured if the task requires AI.
- Your external AI provider account is active, has the required access and is not blocked by quota or billing limits.
- Your server allows outbound HTTPS requests.
- You have a recent backup before major changes.
- You have reviewed the relevant documentation.
Review the relevant documentation before making changes:
API Key Problems
No API Key Detected
If AI Webmaster Studio says that no API key is detected:
- Open the AI Webmaster Studio settings in WordPress.
- Paste your OpenAI API key into the correct API key field.
- Save the settings.
- Reload the settings page.
- Run a small connection test if available.
- Make sure you did not paste extra spaces before or after the key.
AI Webmaster Studio does not issue or supply an API key. Configure your own provider account and key, and never share the key in public content, screenshots, logs or support requests.
Invalid API Key
If the key is invalid or appears not to have been saved:
- check whether the key was copied completely,
- verify that the key was not revoked,
- create a new key in your OpenAI account,
- confirm that the key belongs to the correct provider and project,
- check whether project-level permissions are required,
- save the new key in AI Webmaster Studio and test again.
Never publish your API key in a post, page, screenshot, public log, public repository or support message.
OpenAI Quota, Billing and Limit Errors
If the AI provider returns a quota, billing, rate-limit or account error, review the provider account and project settings before changing WordPress configuration.
- Confirm that billing is enabled if required.
- Review usage limits and rate limits.
- Check whether your provider account or project has enough quota.
- Try a smaller task with shorter input.
- Reduce batch size if you are running bulk actions.
- Wait and retry later if the provider is temporarily rate-limiting requests.
AI Webmaster Studio does not control provider billing, quota, rate limits, model availability or account settings. Resolve these issues in the provider account before repeating the WordPress task.
AI Task Issues
AI Task Does Not Start
Check whether:
- the API key is saved,
- the provider account is active,
- your WordPress user has administrator permissions,
- your WordPress session or nonce has not expired,
- the browser did not block the request,
- the server allows outbound API calls,
- security plugins are not blocking admin AJAX or REST requests.
Reload the page, confirm that the intended page is editable, and try a small test task. If no content is generated, record the visible error and check the task report before trying again.
AI Task Times Out
An AI request may time out because of provider response time, hosting limits, request budgets, network restrictions or excessive input content. A timeout does not confirm whether the task was completed, so check the target content and task report before retrying.
Try reducing the batch size, improving one page at a time, using shorter prompts, avoiding very large pages, checking server timeout limits, reviewing plugin task reports and retrying later if the AI provider is busy.
Content Quality Issues
Generated Content Looks Too Generic
Improve the prompt or task context by specifying the website purpose, audience, product facts, required sections, prohibited claims, verified internal links, tone, language and page objective. If the quality score does not improve, compare the before-and-after content, check whether the target criteria are measurable, and review the output for accuracy before publication.
AI-generated output should always be reviewed before publication.
Generated Content Has Incorrect Claims
Do not publish unsupported claims. Review all claims about product availability, WordPress.org status, pricing, AIWOS Cloud availability, legal/privacy/security obligations, external services and technical capabilities.
Safe wording: AI Webmaster Studio is planned for WordPress.org distribution.
Visual Improvement Issues
Visual Improvement Removed Content
A visual improvement should adjust layout, spacing, hierarchy and readability without removing approved content, changing its meaning or replacing verified links.
- Stop using the visual improvement action on that page.
- Restore the previous WordPress revision.
- Compare word count before and after.
- Check whether headings and links were removed.
- Report the issue to support.
- Use a stricter instruction: “Preserve all approved text. Do not rewrite. Improve layout only.”
Duplicate Title or H1
Some themes print the page title automatically. If AI content also adds a main H1, the page may show duplicate headings. Keep one main H1 and use H2/H3 headings for internal sections.
Internal Linking Issues
Links Point to the Wrong Page
If a link points to the wrong page, inspect the page title, slug and destination, then review every CTA, menu item and internal link. Correct the destination only after verifying that the target page exists and matches the link label. If a slug changed, update the link or request an administrator-approved redirect; do not use the Privacy Policy as a fallback for unrelated topics.
Recommended Canonical Destinations
- Home → /
- AI Webmaster Studio → /ai-webmaster-studio/
- Features → /features/
- Documentation → /documentation/
- Read the Documentation → /read-the-documentation/
- Getting Started → /getting-started/
- API Keys → /api-keys/
- OpenAI API → /openai-api/
- External Services → /external-services/
- Security & Privacy → /security-privacy/
- Troubleshooting → /troubleshooting/
- FAQ → /faq/
- Support → /support/
- Donate → /donate/
- AIWOS Cloud → /aiwos-cloud/
- AIWOS Autopilot → /autopilot/
- Reports → /reports/
- Privacy Policy → /privacy-policy/
- Terms of Use → /terms/
- Changelog → /changelog/
- Roadmap → /roadmap/
Sandbox or External Test Links
Public documentation pages should not link to temporary sandbox domains. If you find links to web-sandbox.oaiusercontent.com, replace them with local links on aiwebmaster.cloud.
Support Checklist
Before contacting support, prepare the AI Webmaster Studio version, WordPress version, PHP version, active theme name, relevant plugin conflict details, permission level, error message, reproduction steps and a screenshot with private data removed. If a plugin conflict is suspected, test only under an approved maintenance procedure and record which plugin, theme or security rule changes the result. Confirm that your WordPress role has permission to edit the target content and run the relevant task.
Do not send private API keys, passwords, administrator credentials, database credentials, server credentials, private customer data or full database dumps.
Support: support@aiwebmaster.cloud