Product Builder selections should carry from the product page to cart, checkout and order data so staff can fulfill the configured product. Use this page to diagnose where that flow is breaking.

Where selections live

• Cart and checkout: selections appear under each line item, using the Cart label set in the group (falls back to the Group Name).
• Order admin screen: selections appear under the order item, plus any uploaded files with download links.
• Customer emails: selections are included in the order confirmation and admin notification.
• Order item meta key: _carticy_pb_selections — readable programmatically via $item->get_meta('_carticy_pb_selections').
• Uploaded files: wp-content/uploads/carticy_pb_uploads/orders/{order_id}/ on the server.

Common issues

• Builder doesn’t appear on the product page: confirm Enable Product Builder is on, the product is published, and the page isn’t a cached fragment from another product.
• Add to Cart blocked: a required group has no selection. The breakdown highlights which group is missing.
• Price mismatch between page and cart: review Differential vs Absolute display, bulk discount tiers and any linked-product modifiers. The frontend calculator and the server-side calculator should match — if they don’t, clear the page cache and rebuild the cart.
• Missing selections in cart: the option group’s Cart label may be empty. Set a short Cart label to keep order lines readable.
• File upload doesn’t reach the order: the file moves from the temporary folder to the order folder when checkout completes. If checkout fails, the file stays in temp and is garbage-collected after a few days — ask the customer to re-upload.
• Unexpected hidden groups: open the modal and simplify the conditional logic. Switch Match from Any to All (or vice versa) to confirm the rules behave as expected.

Compatibility

• WooCommerce Blocks: the builder ships an Integration for the Store API. Selections render correctly in the Blocks cart and checkout.
• HPOS: compatible with WooCommerce High-Performance Order Storage.
• Variable products: the builder layers on top of the selected variation. Formula {base} resolves to the chosen variation’s price.

FAQ

• Can customers upload files? Yes — use the File upload field type. Allowed extensions, size limits and pricing modes are configurable per group.
• Can I link options to specific product variations? Yes. Variations appear in the linked product picker alongside simple products.
• Does stock get reduced on order? Yes — linked products have their stock reduced automatically when the order is placed. See Linked Products and Stock.
• Can developers extend it? Yes. See the Developer Reference for hooks, the FieldTypeInterface and LayoutInterface contracts, and the extension_data bag for custom modal fields.