- Home
- Skills
- E-commerce
- woocommerce checkout qa auditor
woocommerce checkout qa auditor
Audit WooCommerce checkouts for Block compatibility, hook failures, and conversion-killing accessibility issues.
$12
Works with the AI Agents you already use
woocommerce checkout qa auditor
Example session with this skill installed
Audit my child theme and this wc-settings.json. I just switched to the Checkout block and my custom 'referral_source' field stopped showing up on orders.
- Read your context and instructions
- Compiled the woocommerce checkout qa
I have completed the audit of your child theme and WooCommerce settings. The site is running the
WooCommerce Checkout Block.
The audit found that your custom field is registered via woocommerce_checkout_fields, which is ignored by the Block Checkout. Because the Block Checkout uses the Store API, these classic hooks do not trigger, resulting in the field data never being sent to the server.
Checkout Audit Findings
| Priority | Area | Evidence | Business Impact | Fix | Effort |
|---|---|---|---|---|---|
| P0 | Data Loss | inc/custom-fields.php:12 | Referral data is not collected or saved for any orders. | Use woocommerce_register_additional_checkout_field | S |
| P1 | Performance | header.php:42 | Render-blocking script tracking.js delays checkout load. | Add defer or async attribute to the script tag. | S |
| P2 | A11y | html:line 154 | The 'Apply Coupon' button lacks an aria-label. | Update block attributes in Site Editor or via filter. | M |
| P2 | Maintenance | woocommerce/checkout/ | Outdated template overrides detected (v7.0.1). | Remove overrides; Block checkout ignores these files. | S |
Fix Snippet: Modern Field Registration
Replace your classic filter in functions.php or your plugin file with the following Block-compatible registration:
add_action( 'init', function() {
if ( ! function_exists( 'woocommerce_register_additional_checkout_field' ) ) {
return;
}
woocommerce_register_additional_checkout_field( array(
'id' => 'referral-source',
'label' => __( 'How did you hear about us?', 'my-theme' ),
'location' => 'contact',
'type' => 'text',
'attributes' => array(
'required' => true,
),
) );
} );
Next steps
- Implement the
woocommerce_register_additional_checkout_fieldAPI call to ensure data persists to theorder_metatable. - Delete the
woocommerce/checkout/folder from your theme to prevent confusion during future maintenance. - Run the manual test plan below on your staging site.
Manual Test Plan
Field Persistence: Complete a test order and verify the 'referral-source' value appears in the WooCommerce Admin Order Edit screen.
2.
Validation: Try to checkout without filling the referral field; verify the Block Checkout shows a red validation error.
3. Mobile Layout: Verify the new field does not break the layout on narrow viewports (375px).
Connects securely to your tools. The creator never sees your data.
About this skill
Your WooCommerce checkout might be losing sales because of the shift to the Block Checkout. Since WooCommerce 8.3, the default checkout runs on the Store API, meaning classic PHP hooks and template overrides often fail silently. This skill performs a deep, read-only QA audit to identify why fields are missing, validation isn't firing, or payment gateways have disappeared.
What it does
- Checkout type detection identifies if you are running the Block Checkout, classic shortcode, or a mixed setup to determine hook compatibility.
- Hook compatibility analysis scans for PHP hooks and filters that are ignored by the Store API and provides the modern equivalent.
- Payment gateway audit verifies if your active gateways support the block-based flow or if they require a separate integration.
- Accessibility & UX testing checks for missing labels, unnamed buttons, render-blocking scripts, and forced account creation settings.
- Custom field validation debugs Additional Checkout Fields API registrations for correct namespacing, location, and data persistence.
How it works
- Source analysis where the user provides the
wp-contentfolder, WooCommerce settings, or a rendered DOM export of the checkout page. - Automated scanning using a specialized script to detect outdated templates, unsupported hooks, and performance bottlenecks.
- Manual verification against a provided checklist for keyboard navigation, mobile responsiveness, and shipping recalculation logic.
- Prioritized reporting delivering a structured list of P0 data-loss issues down to P3 nits with code-level fix snippets.
Frameworks & tools
This skill is designed for WooCommerce 8.3+ and WordPress environments. It utilizes Node.js for static analysis and references the WooCommerce Store API and Blocks integration patterns.
Why this beats prompting it yourself
Generic AI doesn't know which specific hooks WooCommerce deprecated in the Block transition or how the Store API handles data persistence. This skill uses a verified 2026-11-03 reference table to ensure you aren't using outdated advice that leads to silent data loss.
Use cases
- Auditing a store before migrating from classic shortcode to the Checkout Block.
- Debugging why custom order meta or VAT fields are not saving after an update.
- Identifying performance issues caused by render-blocking scripts in the checkout header.
- Creating a manual QA test matrix for staging environments before a major launch.
Known limitations
Does not place real orders or handle live payment processing. Static analysis cannot verify PCI compliance or gateway account configurations. Rendered DOM is required for accurate Block Checkout audits.
Find more skills like this on the Claude Skills Marketplace, the Codex Skills Marketplace and the Gemini Skills Marketplace, or browse Claude Skills for E-commerce.
Requires rendered DOM for Block Checkout audits. Cannot process live payments or verify PCI compliance. Static analysis of PHP/JS only; cannot fix server-side environment issues.
How to use
- 1
Connect your agent to the Agensi MCP
Copy the prompt and paste it into Claude, ChatGPT, Cursor or any agent that supports MCP. It sets up the connection for you. Manual setup
- 2
Sign in to Agensi
Your agent shows a sign-in link. Sign in and click Allow.
- 3
Ask for what you need
Your agent loads this skill and uses it on your task. It always asks before buying a skill.
Reviews
No reviews yet
Be one of the first to try it. Every listed skill goes through the trust checks below.
Security scanned
Checked by our 8-point scan before listing
Fresh listing
Recently published to Agensi
Money-back guarantee
Doesn't do what its page promises? You get your money back.
Trust & safety
Security scan
Security scan passed 13 days ago
- Software
Node.js