FAQ
SurgeWP helps you plan, generate, and manage custom WordPress blocks using AI.
You can describe a block in plain English or upload a screenshot, and SurgeWP scaffolds a production-ready block for the WordPress block editor.
By default, blocks are generated as native WordPress blocks.
If you need field-driven or dynamic blocks, SurgeWP can optionally generate ACF-based blocks and field groups.
You can preview blocks, iterate safely with version history, review change summaries, and export blocks for production use.
SurgeWP is built for WordPress developers, agencies, and technical teams who regularly ship custom blocks.
It’s also suitable for low-code teams, but you’ll get the most value if you’re comfortable reviewing WordPress, PHP, and JavaScript output before deploying to client sites.
No — ACF Pro is optional.
SurgeWP works out of the box with native WordPress blocks.
If you choose to build ACF-powered blocks, then ACF Pro (v6.7+) is required.
You don’t need to write everything from scratch, but SurgeWP is a developer tool.
The built-in editor, previews, linting, and change summaries make it safe to work quickly, but you should be able to understand and review the generated code before shipping.
No. SurgeWP is for building custom blocks for the WordPress block editor.
It focuses on performance, clean markup, and developer control — not drag-and-drop page building.
SurgeWP supports OpenAI, Anthropic, and Google Gemini.
You can choose the model per request, allowing you to switch providers depending on whether you’re planning, generating code, or fixing issues.
No — SurgeWP is bring your own API keys.
Your usage limits and billing are handled directly by your chosen AI provider.
Ask mode is conversation-only. It helps you plan, reason, or troubleshoot without modifying files.
Agent mode can generate or modify files directly. Every change includes a clear change summary so you can review exactly what was updated.
SurgeWP includes linting and PHP parsing to catch issues early.
If errors occur, you can send them back to AI for targeted fixes or roll back individual files using built-in version history.
SurgeWP generates developer-friendly, production-oriented code, but you should always review output — especially for client work.
Previews, change summaries, and version history exist to help you ship confidently and safely.
Yes. SurgeWP was built specifically to streamline agency workflows.
You can create blocks for one project, then export and reuse them across multiple client sites.
Yes. SurgeWP supports:
• Export to theme
• Export as ZIP
• Export as a plugin
Exporting as a plugin is ideal for maintaining a reusable internal block library.
Version history is tracked per file within the block, so you can roll back specific files without losing everything.
Yes—if your block requires interactions, you can prompt for the required behaviour and SurgeWP can generate the supporting JS. As always, you should review and test in your environment.
Yes. SurgeWP generates blocks using standard WordPress practices, so they work with most modern themes.
Styling may be theme-dependent, especially if your theme enforces specific CSS conventions.
Yes. SurgeWP includes Custom Instructions in Settings, which are appended to every AI request. This is perfect for enforcing Tailwind/Bootstrap rules, naming conventions, or “no jQuery” constraints.
Yes. SurgeWP supports @mentions so you can reference relevant context like post types, taxonomies, or field groups when prompting, which improves accuracy and reduces generic output.
SurgeWP is beginner-friendly in workflow, but it’s still a developer-focused tool.
If you’re new to custom blocks, you’ll learn quickly — but you’ll get the most value if you’re comfortable reviewing code.
Start by generating a simple block (Feature Grid, Hero, CTA), then iterate. Keep requests small, review the change summary, and export blocks you want to reuse.
Make sure you review the SurgeBlocks docs and get familiar with how the plugin works.
If you need help with anything please send an email to hello@surgewp.com