Product Customization (Personalization)

Where to find: Product form → Product Customization card Who it's for: Anyone who wants the customer to add personal information/files to the product during ordering In short: You define fields the customer will fill in when buying (name printing, gift note, file upload, color selection, etc.). If you want, you can add an extra charge to these options.

---

What is customization?

Some products are personalized for the customer. Examples:

• Printing a name on a t-shirt
• Adding a note for a gift
• Uploading a design file for an invitation
• Choosing a personalized color or date

The customization card lets you create these question fields that the customer will encounter on the order screen. The card's description: "Let your customers personalize their orders. For example, you can add name printing or custom note fields."

---

Template logic

Customization fields are kept as a template. A template = a group of fields. You can use the same template on many products; this way you don't set it up from scratch each time.

1. Select a template or create a new one (from the dropdown menu).
2. When you select the template, the fields inside it appear automatically.
3. You can edit fields, delete them, and add new ones.
4. Changes are saved automatically after a short while.

---

Field types (7 kinds)

When adding a customization field, you select one of the following types. The type determines what kind of box the customer will encounter:

---

Adding a field — step by step

1. Click the Add Field button; a new field row (in collapsed form) is added.
2. Open it by clicking the row; the detailed editing appears.
3. Label (required): The question/title the customer will see. E.g. "Type your name". You can't leave it blank.
4. If you want, turn on the Extra Description switch and add a helpful subtext for the customer.
5. Select a type (one of the 7 types above).
6. Fill in the type-specific settings (below).
7. Do the Advanced Settings (optional).

---

Type-specific settings

Text / Paragraph

• Min Characters / Max Characters: The minimum/maximum number of letters the customer can enter.

Selection

• Selection Type: Whether a list, boxes, or image/video options are shown.
• Min / Max Selection Count: The minimum/maximum number of options the customer can check.
• Options: Explained in the "Option list" section below.

Color

• If you want, add predefined colors. If you add them, the customer only chooses from those colors; if you don't add them, the customer can choose any color they want.

File

• Min / Max File Count: The minimum/maximum number of files the customer can upload.
• File Extensions: You select which file types you allow. They're offered in groups:
  • Images: jpg, png, gif, webp, svg, bmp, ico, tiff
  • Videos: mp4, webm, mov, avi, mkv
  • Documents: pdf, doc, docx, txt, rtf, odt
  • Spreadsheets: xls, xlsx, csv, ods
  • Presentations: ppt, pptx, odp
  • There are Select All / Clear All shortcuts.

Date

• Lets the customer choose a date (requires no extra settings).

---

Option list (for Selection and Color types)

When you use the Selection or Color type, you add the options one by one. On each option row:

1. Drag handle: You order the options by dragging.
2. Color box: (For color options) clicking it opens the color picker.
3. Label: The option's name for management (e.g. "Red").
4. Value: The technical equivalent of the option. For image/video options, a media file is selected from here.
5. Price modifier: Does this option have an extra charge?
   • — (none) / Fixed (₺ amount) / Percentage (%)
6. Delete: Removes the option.

For a new option, press the Add button at the bottom of the list.

---

Advanced settings

There's an "Advanced Settings" section under each field:

• Required? If you turn it on, the customer can't place an order without filling in this field.
• Paid? If you turn it on, using this field adds an extra charge (Fixed amount or Percentage).
• Dependency (conditional display): This field appears depending on a specific answer to another field. E.g. if "Is it a gift?" is answered "Yes", the "Gift Note" field appears.

How to set up a dependency

1. In Advanced Settings, select the field to link to (one of the previous fields).
2. Select which answer will trigger this field (e.g. "Yes").
3. Now this field is only visible to the customer when that answer is given.

---

Managing fields

• Order: Move fields up/down by dragging.
• Copy: A field's Copy button duplicates it exactly (fast for similar fields).
• Delete: The Delete button removes the field (a confirmation is asked).
• Copy Template: You can duplicate the whole template along with its fields.

---

Example: Paid color selection

You want to let the customer choose a print color and put an extra charge on some colors:

1. Add Field → Label: "Print Color", Type: Selection.
2. Options:
   • Label "White", Value "white", Price: — (free)
   • Label "Red", Value "red", Price: Fixed 10
   • Label "Black", Value "black", Price: Fixed 10
3. When the customer selects "Red", +10₺ is added to the product price.

---

Validation warnings

• "All field labels must be filled in." → A field's Label is empty.
• "All option labels must be filled in." → An option's Label is empty.
• "Template name is required." → You didn't enter a name when creating a new template.

---

Frequently asked questions

Where does the customer fill in these fields? On the product page, before "Add to Cart".

How is the extra charge reflected? If the customer uses a paid option/field, it's added automatically to the cart total.

If I delete the template, does the product break? Removing the template from the product only cuts the link from that product; the template itself keeps standing and can be used on other products.