Adding personalization on bundles

The Personalization feature allows merchants to add customized input fields to bundle products. This system enables shoppers to provide custom text, upload files, or select specific options (via images, radio buttons, or checkboxes) before adding a bundle to their cart. Merchants can apply these fields conditionally to specific products, make them mandatory, and associate custom charges with the personalization options.

1. Supported Personalization Types

Merchants can introduce the following input types into the bundle flow:

• Text field
• Image selection
• File upload
• Radio selection
• Checkbox

2. Field Configuration & Visibility

Each personalization field requires specific configuration parameters:

• Label: The public-facing name of the field (e.g., "Engraving"). Note: The label does not support dynamic price variables; it acts purely as static text.
• Property Name: The backend identifier used to pass the customer's input data through to the order. This is the field value that appears in the cart, checkout, and order details page.
• Visibility Logic (The Underscore Rule):
• • IF the merchant leaves the "Property Name" as default, THEN the customization data appears in the cart, checkout, and order details page.
  • IF the merchant adds an underscore (_) to the beginning of the "Property Name" value, THEN the system utilizes native Shopify line item property logic to hide the field from the cart and checkout interfaces, while still displaying it on the final order details page.
• Placeholder Text: An optional field to display instructional text inside the input area before the user types.

3. Product Targeting

Merchants control exactly where the personalization fields appear within the bundle:

• IF the merchant selects "all products," THEN the personalization field displays for every product available in that specific bundle step.
• IF the merchant selects "specific products," THEN they must manually define the product subset, and the field will only render when the shopper selects one of those designated items.

4. Validation & Advanced Settings

• Mandatory Logic: IF a field is marked as mandatory, THEN the shopper is blocked from progressing or adding the item to the cart without filling out/selecting the field.
• Custom Error Messages: IF a shopper attempts to skip a mandatory field, THEN the system displays a customizable error message defined in the Advanced Settings.
• Character Limits: For Text fields, merchants can define exact minimum and maximum character limits within the Advanced Settings.

5. Custom Charging Logic

Merchants can charge an additional fee for any personalization option using one of two methods:

• Method A: Charge directly using the Easy Bundles app: The app calculates and adds the specified custom amount to the bundle price natively.
• Method B: Use a Dummy Product: IF this option is selected, THEN the app links the personalization field to an existing, pre-configured product in the merchant's Shopify store (e.g., a standalone "Engraving Fee" product). The app will strictly inherit and apply the native price already assigned to that dummy product in the Shopify admin.

Constraints & Edge Cases

• File Upload Limits: IF the "File upload" personalization type is used, THEN the system accepts any file format, BUT the maximum allowed file size is strictly 10 MB. IF a user attempts to upload a file larger than 10 MB, the upload will fail.
• Label Variables: Contrary to some UI assumptions, dynamic variables (like rendering the live price inside the label text) are NOT supported. The label and Property Name function strictly as static identifiers to pass the data payload to the final order section.
• Multiple Fields: There is no hard limit on the number of personalization fields. A merchant can stack multiple fields (e.g.,

Updated on: 06/08/2026