How to add custom product options in WooCommerce

Use a variation when the choice changes stock, SKU, image or the base price, such as Small, Medium and Large. WooCommerce supports these choices through product attributes and variations.

Use a product add-on when the customer is personalising the item, such as entering engraving text, selecting gift wrapping, uploading artwork or choosing an optional service. Add-ons are not separate products and normally do not have their own SKU or variation stock.

Edit the product and choose Variable product in the Product data panel. Open Attributes, add the options customers can choose, tick the setting that makes the attribute available for variations, and save the attributes.

Open Variations, generate or add the combinations, then set each variation's price, stock, image and other product data. Keep the number of combinations under control: a product with many attributes can quickly become difficult to manage.

For one simple text field, a developer can print the field in the product form, validate the submitted value, store it as cart item data, display it with the cart item and save it to the order line. WooCommerce provides the relevant extension points, including woocommerce_before_add_to_cart_button, woocommerce_add_to_cart_validation, woocommerce_add_cart_item_data, woocommerce_get_item_data and woocommerce_checkout_create_order_line_item.

This route is reasonable for a small, stable requirement. It becomes a maintenance job when you add uploads, conditional logic, dynamic pricing, quantity rules, cart editing or emails. A recurring support problem is saving the value on the product instead of the order item, which makes it disappear from order details and documents.

Whatever route you use, check the complete journey: product page, add-to-cart validation, cart, checkout, order screen, customer email and fulfilment documents. A value that appears on the product page but is not carried into the cart item will not reliably reach the order.

Use stable field names rather than visible labels when custom code or integrations read the data. Also test two different option sets in the same cart; otherwise WooCommerce may merge them as one line item instead of keeping the personalised items separate.

For several custom fields, use an extension rather than maintaining the whole cart and order workflow yourself. Install the extension from Plugins > Add New > Upload Plugin, activate it, then follow its product-options settings.

Create fields such as text, select, radio, checkbox, date or file upload. Set labels, required fields and prices, then assign the options globally or to individual products. Product add-ons documentation commonly supports global rules and product-specific options, with pricing that can be flat, quantity-based or percentage-based depending on the extension.

If the job includes conditional fields, file uploads or option-based pricing, WooCommerce Product Addons is the fast route. Configure the fields from the product editor, set which choices are required, add any price adjustments and preview the product page.

Before publishing, place a test order and confirm that the selected options appear in the cart, order details and emails. Check the upload file type and size limits as well. If your shop only needs size or colour choices, skip the extension and use native variations instead.