How to Set Repeat Rules For WooCommerce Checkout Fields?

Repeat Rules allow you to automatically repeat a field multiple times during checkout based on a specific property such as cart Count or product quantity.

The value of the selected property determines how many times the field will be repeated. The property must resolve to a numeric value.

This feature is useful when customers need to provide separate information for multiple items in the order.

You can repeat checkout fields based on the following properties:

• Product Quantity – Repeats the field based on the quantity of a specific product in the cart. The repetition count is tied to that product’s quantity, not the overall cart total.
• Cart Count – Repeats the field based on the total number of items in the cart. For example, if a customer has 3 items, the field will appear 3 times.
  

Follow the steps below to configure repeat rules for a field:

1. Navigate to WooCommerce → Checkout Form → Checkout Fields.
2. Open the field settings popup by doing one of the following:
   • Click Add Field to create a new field.
   • Click Edit Field to configure an existing field.
3. Navigate to the Repeat Rules tab.
4. Configure the repeat rule based on the required property.
5. Click Save & Close to apply the changes.

The field repeats based on the quantity of a specific product added to the cart.

Use Case: A store sells custom printed T-shirts where customers can order multiple pieces and need to provide a different print text for each.

Example Customer orders:

• 3 × T-Shirt

A field named “Text to Print on T-Shirt” is configured with Repeat Rules based on Product Quantity.

Result: Since the quantity of the T-Shirt is 3, the field repeats 3 times at checkout:

• T-Shirt 1 → Text to Print
• T-Shirt 2 → Text to Print
• T-Shirt 3 → Text to Print

This allows the store to collect individual print instructions for each T-Shirt ordered.

The field repeats based on the total number of items in the cart, including multiple quantities of the same product.

Use Case: A store offers gift wrapping where each item in the cart can have a different wrapping style and a personal note. The store needs to collect separate gift wrapping preferences for every item in the cart.

Example

A customer adds the following to the cart:

• 2 × Scented Candle
• 1 × Watch
• 1 × Wallet

Total items in cart: 4

A field named “Gift Wrapping Preferences” is configured with a Repeat Rule based on Cart Count.

Result: Since the cart contains 4 items in total, the “Gift Wrapping Preferences” field repeats 4 times at checkout:

• Item 1 → Wrapping Style, Personal Note
• Item 2 → Wrapping Style, Personal Note
• Item 3 → Wrapping Style, Personal Note
• Item 4 → Wrapping Style, Personal Note

This allows the store to collect separate gift wrapping preferences for every item in the cart.

When a field is repeated, suffix options help differentiate each instance of the field.

Adds a suffix to the field name stored in the system. Available options:

• Number → 1, 2, 3
• Alphabet → A, B, C

Example:

tshirt_text

tshirt_text_1

tshirt_text_2

Adds a suffix to the label displayed to customers during checkout. This will be displayed in the admin emails, order details page, etc.

Available options:

• Number → 1, 2, 3
• Alphabet → A, B, C
• None

Example:

• Text to Print on T-Shirt
• Text to Print on T-Shirt 1
• Text to Print on T-Shirt 2

Enable this option when the field is placed inside a repeated section and you want its numbering to continue from the parent section’s index.

By default, the first repeated instance of a field does not receive a suffix — numbering begins from the second instance onwards. If you want numbering to start from the very first field (e.g., 1, 2, 3 instead of blank, 2, 3), follow these steps:

1. Set the field label manually to include the starting index — for example: Attendee Name 1
2. Enable Start indexing from parent in the Repeat Rules tab

Result:

• Attendee Name 1
• Attendee Name 2
• Attendee Name 3

This ensures numbering is applied consistently from the first field onwards.