Troubleshooting

Fix Common AI Webmaster Studio Setup, API, Content and Link Issues

AI Webmaster Studio is the free WordPress plugin in the AI Webmaster project. It 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. Most issues are related to API key configuration, OpenAI account limits, WordPress permissions, server restrictions, plugin conflicts, content review settings or incorrect internal links.

Start with a small test task before running larger AI-assisted workflows on important live website content.

Before You Begin

Check the basics first:

  • WordPress is updated.
  • Your active theme is working correctly.
  • AI Webmaster Studio is installed and activated.
  • You are logged in as a WordPress administrator.
  • Your OpenAI API key is configured if the task requires AI.
  • Your external AI provider account is active.
  • Your server allows outbound HTTPS requests.
  • You have a recent backup before major changes.
  • You have reviewed the relevant documentation.

Useful documentation pages:

API Key Problems

No API Key Detected

If AI Webmaster Studio says that no API key is detected:

  1. Open the AI Webmaster Studio settings in WordPress.
  2. Paste your OpenAI API key into the correct API key field.
  3. Save the settings.
  4. Reload the settings page.
  5. Run a small connection test if available.
  6. Make sure you did not paste extra spaces before or after the key.

AI Webmaster Studio does not provide an OpenAI API key. You must use your own provider account and your own key.

Read the API Keys guide

Invalid API Key

If the key is invalid:

  • 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 your AI provider returns quota, billing, rate limit or account errors, check your provider account first.

  • 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 OpenAI billing, quota, rate limits, model availability or provider account settings.

Read the OpenAI API guide

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 and try a small test task.

AI Task Times Out

Large AI tasks may time out because of provider response time, hosting limits, request budgets or large input content.

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. Include website purpose, target audience, product details, required sections, forbidden claims, internal links, tone, language and page goal.

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 being prepared for WordPress.org distribution.

Visual Improvement Issues

Visual Improvement Removed Content

Visual improvement should improve layout, spacing, cards, hierarchy and readability without removing approved content.

  1. Stop using the visual improvement action on that page.
  2. Restore the previous WordPress revision.
  3. Compare word count before and after.
  4. Check whether headings and links were removed.
  5. Report the issue to support.
  6. 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.

Support Checklist

Before contacting support, prepare AI Webmaster Studio version, WordPress version, PHP version, active theme name, error message, reproduction steps and a screenshot with private data removed.

Do not send private API keys, passwords, administrator credentials, database credentials, server credentials, private customer data or full database dumps.

Support: support@aiwebmaster.cloud

Contact support

Related Pages

Scroll to Top