Skip to main content

Use macros in forms

A macro is a placeholder that gets replaced with specific data when inserted into a form, an automated email, or a text message.

Important

  • You can use macros in all applicable components added to the form.

    This also applies to the text added to the form using the content component.

  • When you choose a macro for a field, it automatically pulls information from your database and makes an entry into the field.

  • When the user is filling out the form, they can edit the field.

  • If you want to make the macro-enabled field non-editable, under the Basic tab, select the Disable check box.

  • The macros available on the form depend on the type of form selected.

    For example, a membership form will have macros related to memberships only.

Examples of forms where macros can be used
  • A form that needs demographic details of guests with fields for guests' names, addresses, and contact details.

  • A form for gathering service information with fields for the service name, therapist name, and appointment details.

Use macros in HTML forms
  1. Build a custom HTML form in Zenoti 

  2. To fit a specific purpose in your form while writing the code, you can use the macros below.

  3. Click Save.

Use macros in form builder
  1. Create a form or open an existing form.

  2. From the components list, add any of the following components.

    • Text field

    • Text area

    • Email

    • Date/Time

  3. To customize the component, click Edit.

    To display a macro as a response on the component, under the Basic tab, from the Macros list, select a macro.

    For the list of macros used, refer to the table below.

    macros.png
  4. Click Save.

Macros

Description

[GuestCode] 

Unique identification code assigned to your guests when you enter their details in Zenoti

Note

You can manually enter a unique code for each guest while creating the guest’s profile in Zenoti, or enable the Auto-generate guest code to automatically generate a guest code.

  1. At the organization level, click the Configuration icon.

  2. Search for and select Auto-generate guest code from under Guests.

  3. Enable the Auto-generate guest code setting.

  4. Click Save.

[GuestName] 

Full name of the guest registered on the guest profile

[GuestFirstName] 

First name of the guest registered on the guest profile

[GuestLastName] 

Last name of the guest registered on the guest profile

[GuestPostalCode] 

The postal code of the guest’s address registered on the guest profile

[GuestEmail] and [GuestEmailAddress]

Email address of the guest registered on the guest profile

[GuestMobilePhone] 

Mobile phone number registered on the guest profile

[GuestHomePhone] 

Home phone number registered on the guest profile

[GuestWorkPhone] 

Work phone number registered on the guest profile

[GuestDob] 

Date of birth of the guest registered in the guest profile

[GuestGender] 

The guest's gender registered in the guest profile

[GuestAddress] 

The complete billing address of the guest registered in the guest profile

[GuestAddress1] 

Alternative address of the guest registered in the guest profile

[GuestAddress2] 

Alternative address of the guest registered in the guest profile

[GuestCity] 

City where the guest resides

[GuestState] 

State where the guest resides

[GuestCountry] 

Country of the guest registered in the guest profile

[GuestReferral] 

The referral that guests can send to avail of any referral benefits

[GuestReferredBy] 

The source of referral from which the guest was referred

[TherapistName] 

Name of the service provider who performed the service

[OrganizationName] 

Name of the center’s organization

[CenterName] 

Name of the center where a service is booked

[CompanyName] 

Name of the company set at the center level settings

The Company name field at the center level (Configuration > Business details > Essentials > Contact details > Company Name).

[CenterCity] 

City where the center is located

[CenterState] 

State where the center is located

[CenterCountry] 

Country where the center is located

[CenterAddlData1] 

Additional center information provided in the Additional text field in the guest's base center Settings > Invoice & Receipts

[CenterAddress] 

Complete address of the center (corresponds to the Address 1 and Address 2 field in the center settings)

[CenterZip] 

Zip code/postal code of the center’s location

[CenterPhone] 

Center’s phone number (corresponds to the Phone field in the center’s settings)

[CenterPhone2] 

The secondary phone number provided for the guest's base center (corresponds to the Phone 2 field in the center settings)

[CenterEmail] 

Email address of the center.

[ServiceName] 

Name of the service for which the appointment is booked

[AppointmentStartTime] 

The start time of the appointment

[AppointmentDate] 

The date of the appointment

[AppointmentEndTime] 

The end time of the appointment

[InvoiceStatus] 

The status of the invoice at the time of filling the form

[GuestZipCode] 

Zip code of the address of the guest

[PackageType] 

The type of package: Day, Promotional, Series, or Custom Package

[PackageInvoiceNumber] 

The invoice number from package sale

[PackageValidFrom] 

Start date of the validity of the package

[PackageValidTill] 

End date of the validity of the package

[PackageSoldBy] 

Name of the employee who sold the package

[PackagePrice] 

The total price of the package associated with the form

[PackagePaymentMethod] 

The payment method used to purchase the package

[PackageCountofScheduledPayments] 

The number of payments scheduled for the payment of this package

[PackageFirstScheduledPaymentDate] 

The date on which the first payment was done for the package

[PackageNextScheduledPaymentDate] 

The upcoming date of payment for this package

[PackageLastScheduledPaymentDate] 

The date on which payment of packages is scheduled to end

[PackageTherapistName] 

The name of the service provider performing services in the package

[PackageTherapistPhone] 

The mobile number of the service provider performing services in the package

[InvoiceID] 

The identification number of the invoice for the appointment or purchase made

Invoice ID is auto-generated by the system.

[InvoiceCreationDate] 

The creation date of the invoice linked to the form

[InvoiceNumber] 

The number mentioned on the invoice that is used to identify the purchase

Invoice number is set at the organization level settings

[NamesOfAllPackagesInTheInvoice] 

All the packages sold on the invoice

[CategoryOfAllPackagesInTheInvoice] 

The category of each package sold on the invoice

[QuantityOfEachPackageSoldInTheInvoice] 

The number of each package sold on the invoice

[FirstInstallment] 

The amount set for the first installment at the time of package creation

[TotalDueMinusFirstInstallment] 

The amount due for payment after the first installment

[ScheduleOfPayments] 

Schedule and details of payments configured in the package settings

Example: Your package has monthly payments scheduled to be taken on the 14th of every month, the macro will display a table with dates and amounts of the scheduled payments.

package_form_macro_table_format.png

[NameOnCard] 

Name of the cardholder whose card is on the invoice

[CardType] 

Type of the card used for the payment on the invoice

Example: Mastercard or Visa

[CardNumber] 

The number on the card used for payments

[BillingZipCode] 

Zip code added to the guest profile while adding the card

[PackageSoldByEmployeeJobTitle] 

Job title of the employee who sold the package on the invoice

[NameAndTypeOfAllItemsInInvoice] 

List of all items on the invoice including services, packages, products, and memberships

[TodaysDate] 

Current date

[MembershipName] 

Name of the membership associated with the form

[MembershipNumber] 

The number assigned to the membership that is sold at the center

[MembershipInvoiceNumber] 

The number of the invoice generated when the package was sold

[MembershipType] 

The type of membership: Recurring, Non-recurring, Service Credits, Credit Value, or Discounts Only

[MembershipDuration] 

Duration of the membership set while creation of the membership

[MembershipValidFrom] 

Date when the membership becomes active

[MembershipSoldBy] 

Name of the employee who sold the membership

[MembershipPrice] 

The price defined in the membership settings

[SetupFee] 

The setup fee defined at the membership

[RecurringFee] 

Recurring fee charged towards membership

[Mem#OfCollections] 

The total number of collections made toward the membership

[MembershipPaymentMethod] 

Type of payment method used towards membership fees

[MemFirstCollectionDate] 

Date when the first fee is collected for the membership

[MemNextCollectionDate] 

Date when the next fee is collected towards the membership fee

[MemExpiryDate] 

The date at which the membership is set to expire

[MembershipLockin] 

Lock-in period defined for the membership

The lock-in period refers to the number of payments that the guests need to complete before they can cancel the membership.

[MemBalance] 

Total credit balance available in the membership

[MemRenewalPrice] 

Membership renewal price for a recurring membership

[BackupPaymentDetails]

Secondary payment entered on the POS screen at the time of sale

[BuyOutFee]

Fee that is collected for the cancellation of a membership

This is defined at the creation of the membership

[DDPaymentDetails]

Details of direct debit for the purchase of the membership

[DeclineFee]

Fee charged for a failed transaction

[DefaultPaymentDetails]

Default (primary) payment entered on the POS screen at the time of sale

[GuestAge]

Guest's age is calculated based on the guest's date of birth registered in the profile

[GuestEmailAddress]

Email address of the guest registered on the guest profile

[MembershipExpiry]

Date at which the membership is set to expire (in the membership settings)

[MembershipFeeDiscountPeriod]

Duration for which the discount on the membership fee is applicable

[MembershipInvoiceNo]

Invoice number generated when the membership was sold

[MembershipLockinCycles]

Number of collections to be taken before the membership can be cancelled

The lock-in period refers to the number of payments that the guests need to complete before they can cancel the membership.

[MembershipLockinRestriction]

Type of restriction set when the membership is created: No restriction or with a restriction of lock in cycles

[MemPaymentMethod]

Type of payment method used towards membership fees

[Minor]

Whether the guest is a minor

The value of this macro will be either Yes or No.

Determined based on the guest's date of birth registered in the profile

[RecMemAnnualFee]

Annual fee of the recurring membership

This is set at the creation of the membership

[RecMemAnnualFeeDiscount]

Discount given on the annual fee of the recurring membership on the invoice at the time of sale (on the POS screen)

[RecMemAnnualFeeDiscountPeriod]

The number of installments for which the discount on the annual fee of a recurring membership has been applied applicable

[RecMemAnnualFeeDueDate]

Date on which the annual fee collection invoice is generated for a recurring membership

[RecMemAnnualFeeFinalSalePrice]

Final annual fee for the recurring membership on the invoice at the time of sale

[RecMembershipName]

Name of the recurring membership on the invoice

[RecMembershipSaleDate]

Date on which the recurring membership was sold

[RecMemFinalListFee]

Fee listed in the membership settings after addition of tax and applying discount(if any)

[RecMemFinalSalePrice]

Final sale price after discount (if any) for the recurring membership on the invoice

[RecMemListPrice]

Fee listed in the membership settings before tax and discount

[RecMemSaleDiscount]

Discount to be applied on the membership sale price

[RecMemSalePrice]

Prorated fees before discount

[RecMemSetupFeeCollectionDate]

Date on which set up fee collection invoice is generated for a recurring membership

[RecMemSetupFeeDiscount]

Discount given on the setup fee on the POS screen at the time of sale of a recurring membership

[RecMemSetupFeeFinalPrice]

Final setup fee (calculated after discount and taxes) for the recurring membership on the POS screen at the time of sale

[RecurringMemFeeDueDate]

Date on which the recurring fee for a recurring membership is scheduled to be collected

[RecurringMemFeeSecondDueDate]

Date on which the next recurring fee is scheduled to be collected

It is the date of the second payment from the current cycle in the payment frequency setting taken from the membership settings.

For example, if a recurring membership is set to take payments every month and it is bought in March, this macro gives details of the payment that is due in May (second cycle of payment).

[RecMembershipFeeDiscount]

Discount defined on the POS screen at the time of sale of the membership