As WooCommerce developers, we often bounce between documentation, GitHub issues, API references, support forums, changelogs, and tutorials. But what if we could cut through the noise and get straight to what we need — using smart AI prompts?
In this article, I’ve compiled 20 useful ChatGPT prompts, each tailored to a specific area of WooCommerce development.
Whether you’re digging into official docs, exploring REST APIs, or figuring out how to extend product types, each example gives you a URL, a prompt, and a specific outcome. These aren’t code snippets (although some prompts might output code) — they’re thinking tools to help you understand, decide, or act faster.
Use them to make sense of messy docs, draft custom code, or even summarize discussions from GitHub issues. Once you get the hang of these, you can start building your own AI workflows around WooCommerce development.
Official Documentation & Use Cases
WooCommerce’s official documentation is vast, but not always developer-optimized. Searching for the right guidance on product variations, shipping zones, or tax settings often takes longer than it should.
These prompts help you extract the actionable stuff — setup steps, feature limitations, and practical usage advice — so you can spend less time digging and more time building. Whether you’re setting up your first store or fine-tuning a multi-zone shipping system, these AI-powered prompts turn longform documentation into quick, relevant summaries or checklists.
Prompt 1 – Product Variations Summary
Act as a WooCommerce technical writer. Read the official documentation at https://woocommerce.com/document/variable-product/ and summarize how product variations are created, configured, and displayed. Structure the output into: Setup Steps, Common Issues, and Gotchas.
Prompt 2 – Shipping Zones Setup Checklist
I'm setting up complex shipping rules in WooCommerce. Use https://woocommerce.com/document/setting-up-shipping-zones/ and give me a step-by-step checklist to configure: 1) multiple zones, 2) flat rate + free shipping mix, and 3) product-category-specific rules.
Developer Docs & Hooks
WooCommerce’s power lies in its extensibility — and that means knowing your hooks. But with hundreds of actions and filters, it’s easy to misfire or choose the wrong one.
These prompts help you navigate the developer.woocommerce.com ecosystem: understanding when a hook fires, how to implement it safely, and even anticipating upcoming changes that might affect your plugin.
Use these to extract precise technical context, generate example usage, or scan the dev blog for compatibility alerts.
Prompt 3 – Explain a Specific Hook
I found the woocommerce_checkout_update_order_meta action in the dev docs: https://developer.woocommerce.com/. Explain what this hook does, when it runs, and show me a working PHP snippet that saves a custom field from the checkout page.
Prompt 4 – Detect Plugin Compatibility Warnings
Read the WooCommerce Developer Blog at https://developer.woocommerce.com/ and tell me which upcoming WooCommerce changes might break my plugin if I use direct database access for orders or custom meta.
REST API Workflows
The WooCommerce REST API is extremely useful but can be intimidating, especially when working with auth, pagination, or nested product data.
These prompts help you interface with the official REST docs to get exactly what you need—fetching products, updating inventory, managing orders—with examples in curl or JSON. Whether you’re building a headless front-end, syncing with an ERP, or running server-to-server jobs, this section helps you communicate clearly with the API.
Prompt 5 – Basic Product Fetch via REST API
Generate a curl command to fetch all published products from a WooCommerce site using the REST API v3. Use the docs at https://woocommerce.github.io/woocommerce-rest-api-docs/. Explain required parameters, authentication, and pagination.
Prompt 6 – Update Product Stock via API
Act like a WooCommerce API developer. Based on https://woocommerce.github.io/woocommerce-rest-api-docs/, show me how to send a PUT request to update stock quantity of a product with ID 123. Include the full JSON body and example headers.
GitHub Issues & Source Code
Many WooCommerce problems, bug reports, and roadmap items live inside GitHub issues — and often go unnoticed unless you’re actively tracking them. Likewise, diving into core code to figure out how a hook works can be tedious.
These prompts help you digest long GitHub threads, track bug resolution progress, or trace where exactly a filter or action lives in the codebase. Great for plugin authors and advanced users who need to stay one step ahead of Woo updates.
Prompt 7 – Summarize a GitHub Issue
Read the discussion at https://github.com/woocommerce/woocommerce/issues/59673 and summarize: 1) the issue being reported, 2) the responses from Woo team, 3) any suggested workaround, and 4) whether it's fixed.
Prompt 8 – Find the Hook Source in Core Code
Help me locate the source of the woocommerce_email_order_meta_fields filter hook in the WooCommerce GitHub repo. Tell me which file it's in, which class/method calls it, and what parameters it passes. Use https://github.com/woocommerce/woocommerce as a source.
Code Reference & Internals
Sometimes you just need to understand what a WooCommerce class does—or how to extend it properly.
These prompts leverage the code reference to break down key classes like WC_Product, explain how they’re structured, and help you avoid subclassing mistakes. You’ll also get side-by-side comparisons of similar hooks or functions so you can confidently pick the right one for your needs. This section is perfect for developers who want to go deeper into Woo core.
Prompt 9 – Explain WC_Product Class Usage
Read https://woocommerce.github.io/code-reference/classes/WC-Product.html and explain what the WC_Product class does, how it relates to other product types, and which 5 methods are most useful when building custom templates.
Prompt 10 – Compare Similar Hooks
What’s the difference between woocommerce_before_calculate_totals and woocommerce_cart_calculate_fees? Show me use cases for each and help me choose which one to use if I want to apply a category-based fee during cart calculation.
HPOS & Database Structure
With High-Performance Order Storage (HPOS) becoming the default, WooCommerce developers need to rethink how they interact with orders, meta, and custom tables.
These prompts guide you through HPOS migration steps, plugin compatibility declarations, and even writing raw SQL against the new schema. Use this section to future-proof your plugins, test data access patterns, and ensure your site doesn’t crash during major updates. Whether you’re refactoring code or planning for long-term support, HPOS is not optional anymore.
Prompt 11 – Prepare for HPOS Migration
I maintain a plugin that saves custom order meta. Use https://developer.woocommerce.com/2023/05/02/high-performance-order-storage-hpos-migration-guide/ to create a checklist for making my plugin HPOS-compatible.
Prompt 12 – Custom SQL Queries with HPOS Tables
Act like a database admin. Show me how to write a raw SQL query that retrieves order IDs and customer emails using HPOS tables. Base your output on the HPOS schema from the WooCommerce docs.
WooCommerce Blocks & Frontend
WooCommerce Blocks bring the power of Gutenberg to the shop and checkout—but extending them requires some familiarity with React, JSX, and client-side data flow.
These prompts help you explore what’s possible with Blocks: injecting UI into the checkout, comparing classic vs. block architecture, or understanding where things are headed. Use this section to evaluate whether Blocks are right for your store and how to customize them in a future-compatible way.
Prompt 13 – Customize a Checkout Block
I’m building a custom Checkout Block extension. Use https://developer.woocommerce.com/category/blocks/ and give me a step-by-step guide to inject a message below the billing fields using extensibility APIs.
Prompt 14 – Compare Classic vs Block Checkout
I’m unsure whether to switch to the Checkout Block. Compare Classic vs Block Checkout in WooCommerce: features, extensibility, limitations, and plugin support. Use insights from https://developer.woocommerce.com/category/blocks/.
Releases & Changelogs
Staying on top of WooCommerce core releases is critical for plugin devs and advanced store owners. But changelogs can be dense and sometimes cryptic.
These prompts help you monitor breaking changes, scan changelogs for hook or DB changes, and even predict what might break based on your current setup. Whether you’re planning a major update or doing pre-release compatibility testing, this section turns Woo changelogs into a tool, not a chore.
Prompt 15 – Summarize Breaking Changes
Visit the latest WooCommerce release notes at https://github.com/woocommerce/woocommerce/releases. List any breaking changes for developers and give me one-liner explanations of what changed and how it could affect custom plugins.
Prompt 16 – Predict What Will Break After Update
My site has customizations that hook into order item meta. Based on recent WooCommerce releases and dev blog posts, predict what issues I might face when updating to WooCommerce 10.0.
Performance, Testing, and Tools
Performance bottlenecks and missing test coverage are two of the biggest risks on WooCommerce sites.
These prompts help you run realistic load tests, choose the right benchmarking tools, and even write PHPUnit tests for custom functionality. Use this section to prepare for scale, measure API throughput, or build confidence in your own plugin’s behavior. Whether you’re optimizing for Black Friday or building a stable enterprise store, these tools can save you from costly downtime.
Prompt 17 – Suggest Tools for WooCommerce Load Testing
What tools can I use to simulate 1,000 concurrent WooCommerce checkouts to stress test a site? Provide CLI commands, Docker-compatible options, or SaaS tools. Output a list with pros/cons.
Prompt 18 – Write PHPUnit Test for Custom Function
I wrote a function that adds a custom fee to the cart. Help me write a PHPUnit test for it, assuming I’m using WooCommerce’s testing framework. Output the full test class and explain the setup.
Site Building & Optimization
Not every WooCommerce task is about hooks and functions—sometimes you need help evaluating a plugin, debugging a frontend error, or comparing third-party add-ons.
These prompts help you get actionable answers when documentation doesn’t exist or when you need a developer-minded decision guide. From plugin comparison to staging bug resolution, this section is perfect when you’re trying to make smart technical choices outside of pure code.
Prompt 19 – Compare 3 Product Add-on Plugins
I need to allow customers to upload a file and enter custom text on a product page. Compare 3 top-rated WooCommerce product add-on plugins (official or not), listing pricing, features, and limitations.
Prompt 20 – Detect Plugin Conflicts on Staging
Act as a WooCommerce support engineer. I’m seeing a “checkout error” on staging but not on live. Guide me through how to debug this step by step using staging tools, log files, and conflict testing plugins.
Some ChatGPT Outputs
To show the value of these prompts, here are a few real examples of ChatGPT’s responses using the exact wording listed above.
You’ll notice that the answers are practical, structured, and often ready to copy and paste — or at least use as a draft. These aren’t vague summaries; they’re tailored, developer-focused results that save time.
From hook explanations to API requests and changelog breakdowns, the quality depends entirely on how specific the prompt is. The better you define your goal, the better the AI performs — so use these as templates and tweak them for your own workflow.
Prompt 1 Output
This prompt asked for a summary of how WooCommerce product variations are created, configured, and displayed, based on the official documentation — and to organize the output into three sections: Setup Steps, Common Issues, and Gotchas.
The summary is nearly complete and well-structured, accurately describing how WooCommerce product variations are created and configured. It walks through setting the product type, adding attributes, generating variations, and assigning prices — all essential steps.
It also highlights typical issues like missing prices, stock problems, and attribute misconfigurations. The gotchas section adds valuable nuance around variation-specific inventory, global vs custom attributes, and caching.
The tone and structure suit a technical audience, though it could briefly touch on how variations display on the frontend. Overall, the output is precise, helpful, and aligned with WooCommerce documentation and real-world usage:
Certainly. Here’s a structured summary of how WooCommerce variable products are created, configured, and displayed, based on the official documentation at https://woocommerce.com/document/variable-product/.
Setup Steps
1. Create a Variable Product
- Go to Products > Add New (or edit an existing product).
- In the Product Data panel, select Variable product from the dropdown.
2. Add Attributes
- Navigate to the Attributes tab in the Product Data panel.
- Select an existing attribute (e.g. Color, Size) or create a custom product attribute.
- Enable both “Used for variations” and “Visible on the product page”.
- Add values separated by a pipe (
|), like:Small | Medium | Large, then save attributes.
3. Generate Variations
- Go to the Variations tab.
- Click “Add variation” > “Create variations from all attributes” > Go.
- WooCommerce auto-creates a variation for each combination of selected attribute values.
4. Configure Variations
- Each variation can be edited individually:
- Set price (required).
- Upload an image.
- Manage stock, weight, dimensions, SKU, sale schedule, etc.
5. Save and Publish
- Make sure each variation has a price (or it won’t show).
- Save changes and publish the product.
Common Issues
Variations Not Showing
- Variations must have a price. Without one, they won’t appear on the frontend.
- Ensure the correct attribute terms are selected and marked as “used for variations.”
“No Available Options” on the Product Page
- This usually means WooCommerce couldn’t find any valid variation combinations.
- Recheck attributes and ensure variations are created for each combination.
Variation Images Not Updating
- Each variation must have its own image set — otherwise, the main product image is reused.
Performance Issues
- Products with 100+ variations can load slowly or time out in the admin or frontend.
Gotchas
Manual vs Auto Variation Creation
- If you create variations manually, you must add one for each attribute combination yourself. Use “Create variations from all attributes” to save time.
Missing Required Fields
- Without a price, variation won’t show.
- If stock management is enabled but no quantity is entered, the variation may appear as out of stock.
Inventory Per Variation
- Stock is managed per variation, not per attribute. So you can’t say “10 Red” across all sizes — you need 10 for “Red / Small”, “Red / Medium”, etc.
Custom Attribute Slugs
- Custom attributes created per product (not global attributes) won’t be reusable or filterable in layered navigation unless added globally via Products > Attributes.
Caching Issues
- Sometimes, variations don’t update due to cache. Always clear object/page cache and test in incognito when making changes.
Prompt 11 Output
The prompt is clear, specific, and provides a reliable source — ideal for technical documentation tasks. It asks for a checklist based on WooCommerce’s HPOS migration guide and describes the plugin’s context (custom order meta), which ensures relevance.
The response is well-aligned with the request: it’s structured, accurate, and concise, covering registration, meta handling, compatibility declaration, and testing. Each point includes code where helpful and avoids unnecessary fluff.
It directly reflects the WooCommerce migration guide’s recommendations. Overall, both prompt and response demonstrate effective communication, practical application, and a solid understanding of WooCommerce development best practices:
Here’s a concise yet comprehensive checklist to help you make your plugin compatible with High-Performance Order Storage (HPOS), based on the official WooCommerce migration guide:
HPOS Compatibility Checklist for Custom Order Meta
Confirm WooCommerce Compatibility
- ✅ Your plugin requires WooCommerce 7.1+ (HPOS feature introduced) or higher.
Use wc_get_orders() Instead of Direct SQL
- ✅ Avoid direct queries to
wp_posts/wp_postmeta. - ✅ Use WooCommerce CRUD functions like
wc_get_order()and$order->get_meta()to retrieve custom order meta.
Register Meta with woocommerce_store_order_meta_keys
- ✅ Add your custom meta keys using the
woocommerce_store_order_meta_keysfilter:
add_filter( 'woocommerce_store_order_meta_keys', function( $meta_keys ) {
$meta_keys[] = '_my_custom_meta_key';
return $meta_keys;
});
Support Both HPOS and Legacy Systems
- ✅ Avoid assuming
shop_orderis always a post — support bothshop_orderandwoocommerce_order. - ✅ Use feature detection to check if HPOS is enabled:
if ( function_exists( 'wc_get_container' ) && wc_get_container()->get( \Automattic\WooCommerce\Utilities\OrderUtil::class )::custom_orders_table_usage_is_enabled() ) {
// HPOS is enabled
}
Don’t Depend on Post IDs
- ✅ Use
get_id()on order objects instead of relying onpost->ID. - ✅ Avoid querying post tables for order data.
Register Compatibility via DeclareCompatibility
- ✅ Add this to your main plugin file:
add_action( 'before_woocommerce_init', function() {
if ( class_exists( \Automattic\WooCommerce\Utilities\FeaturesUtil::class ) ) {
\Automattic\WooCommerce\Utilities\FeaturesUtil::declare_compatibility(
'custom_order_tables',
__FILE__,
true
);
}
});
Test Under Both Modes
- ✅ Test plugin functionality with both HPOS and legacy (WP posts) modes enabled.
- ✅ Ensure meta is saved/retrieved consistently in both.
Avoid get_post_meta() / update_post_meta()
- ✅ Replace with:
$order = wc_get_order( $order_id );
$order->update_meta_data( '_key', 'value' );
$order->save();
Use Action Hooks, Not Post Status
- ✅ Hook into
woocommerce_new_order,woocommerce_order_status_changed, etc., notsave_post.







