Custom Fields

Custom Fields

Adapt your catalog and checkout with personalization, paid options, numeric inputs, dates, and appointment slots.

Custom fields let you adapt Pi-Square to the way your business works. Collect a message for a cake, offer different sizes or finishes, charge for extra quantities, or let customers select an appointment slot. Use item fields for choices specific to a product or service, and order fields for information or add-ons that apply to the whole order.

Item Custom Fields

Open an item in Items Management, expand Advanced Settings, and select Add custom field. Set the field name, type, and any type-specific options, then save the item. You can add up to 10 custom fields per item, including at most one Appointment field.

For example, a cake could have a Text field called Frosting with priced choices, and another Text field called Name on Cake for a personal message. A consultation could have an Appointment field called Session Time.

Additional charges from item fields are added to the item’s selling price. For example, if a cake costs ₹500 and the selected frosting adds ₹100, the customized item costs ₹600 per item.

Order Custom Fields

Open Site Settings and expand Order Custom Fields. The section name follows your site’s transaction terminology. Add a field, configure its options, and save the settings. You can add up to 10 fields per site.

These fields apply to the whole order. For example, offer a Celebration Hamper choice with an additional charge, or collect a Gift Message. An order-level charge applies once to the order rather than to each item.

Text, Number, Whole Number, and Date fields are available at order level. Appointment fields are available only on items.

Field Settings

Each field has:

• Field Name: The label shown to the customer, such as Frosting, Extra Candles, or Session Time. Use a unique name within the item’s fields or the site’s order fields. Names can contain up to 20 characters.
• Field Type: Determines the input and the configuration options described below.
• Default Value (Optional): A starting value that must satisfy the field’s rules. For Text fields with allowed values, the first visible choice is used when no explicit default is set.

Field Types

Text

Use Text for free-form input, such as a name or message, or for a list of choices, such as size or frosting.

Leave Allowed Values empty for free-form input. To offer choices, select Add Allowed Value and enter each value with its + Price. You can add up to 100 allowed values. A price of zero means there is no additional charge for that choice.

Use the visibility icon beside a choice to hide it temporarily without deleting it. Hidden choices cannot be selected. If you hide a choice that was the default, update the default to an available choice.

For example, offer Whipped Cream at ₹0 extra and Butter Cream at ₹100 extra. Customers choose from the visible allowed values.

Whole Number

Use Whole Number for non-negative integer quantities, such as extra candles or additional guests.

Set optional Min and Max values to limit the input. Set Unit Price to charge for each unit entered. For example, an Extra Candles field with a unit price of ₹10 adds ₹30 when the customer enters 3.

Number

Use Number for non-negative decimal values, such as a measurement or weight.

Set optional Min, Max, and Max Fraction Digits to control the accepted range and precision. Unit Price adds a charge equal to the entered value multiplied by the unit price. For example, an Extra Weight field with a unit price of ₹200 adds ₹100 for a value of 0.5.

Both numeric types can collect information without adding a charge: leave Unit Price empty.

Date

Use Date to collect a date or a date with time. Choose Date Format from the available formats, including day-month-year, month-year, year, and a date with an hourly time.

Set optional Min and Max bounds. You can enter:

• A fixed value matching the selected format, such as 31-12-2026 for dd-MM-yyyy.
• today or now for a bound relative to the current date or time.
• A relative offset such as +7d or +30d. Supported units are d for days, m for months, y for years, h for hours, and uppercase M for minutes. Negative offsets are also supported.

For example, set Min to +2d and Max to +30d to accept dates from two days ahead through thirty days ahead. Relative bounds move with the current date. Date fields do not add charges.

Use an Appointment field when you need scheduled slots and availability rules.

Appointment

Use Appointment on an item to let customers select a scheduled date and time. Each item can have at most one Appointment field; this type is unavailable for order fields.

Configure:

• Date Time Format: How the appointment date and time are displayed.
• Duration / Slot Interval (Minutes): The appointment length and spacing between slot start times.
• Separate Slot Interval: Enable this to set the appointment duration and slot spacing independently. For example, a 60-minute service can offer start times every 30 minutes.
• Min Notice (Minutes): How much advance notice is required. Presets include hours and days.
• Max Advance (Days): How far ahead customers can book. This window must be longer than the minimum notice period.
• Availability: Add start and end times for individual days or use Any Weekday. Add multiple windows for breaks or split opening hours. You can copy or delete a window.
• Unavailable Dates: Block specific dates, such as holidays, within the advance booking window.

For example, a consultation can last 30 minutes, require 2 hours’ notice, allow bookings up to 14 days ahead, and offer morning and afternoon availability windows. Appointment fields do not add a separate charge; set the service’s price on the item.

Custom Fields in CSV

Item custom fields are included in the Custom Fields column when you export or import items. This column contains JSON configuration. Configure fields in the app and export them rather than writing the JSON by hand. You can copy the configuration between items that need the same fields.