ZenotiHelp

Create and search for guests

ZTZenoti Docs Team Updated October 27, 2026 15 min readGuide

Finding existing guests and creating new guest records are two of the most frequent tasks at the front desk. Zenoti provides guest search from the appointment book, the booking wizard, and within the guest profile itself. When a search returns no results, you can create a new guest directly from the search interface.

Audience: Front desk staff who manage guest records and conduct daily guest interactions.

Which experience does this article cover? This article describes the redesigned guest profile and the redesigned appointment book search. The redesigned experience adds cross-center search, a past-searches list, and an inline action to start a booking from a search result. The legacy guest profile and legacy appointment book are still in use at some centers; legacy-only differences are flagged inline below. Contact your Zenoti representative if you have not yet transitioned.


On this page


Before you begin

  • You need the Guests permission under the Guest Manager section to search for guest records.
  • You need Add permission under Guests to create new guest records.
  • Mandatory guest field rules are configured at the organization scope, not per center. An administrator configures which fields are required β€” and which trigger a booking block when missing β€” in Configure guest settings.

Permission: Add (under Guests) β€” required to create new guest records.

Admin path: Configuration > Security > Security roles > [your role] > PERMISSIONS > Guest Manager > Guests > Add

Note: The Block booking of appointment if any required fields are missing setting, when enabled, enforces mandatory-field completion for in-store bookings made from the Appointment Book bottom panel. This enforcement does not apply to online bookings made through the Webstore or the Consumer Mobile App.


Search for a guest

In the redesigned experience, you can search for guests by name, phone number, or email address. The system requires a minimum of three characters before it triggers a search. Search results appear in a dropdown overlay showing matching guest records.

Legacy experience: In the legacy appointment book, you can also search by guest code. Guest code is not a search parameter in the redesigned appointment book search.

Search from the appointment book

  1. Click the guest search field in the appointment book.
  2. Type at least three characters of the guest's name, phone number, or email address.
  3. The search overlay displays matching results.
  4. Click a guest name to open their guest profile.

Search from the booking wizard

When creating a new appointment in the booking wizard:

  1. In the guest selection step, type at least three characters in the search field.
  2. Select the guest from the search results to proceed with the booking.

If the guest does not exist, you can create a new guest directly from the booking wizard without closing it.

Search from within the guest profile

The guest profile includes a search field that allows you to switch to a different guest without closing the panel:

  1. Use the search field within the guest profile panel.
  2. Type at least three characters to trigger the search.
  3. Select a guest from the results to switch the profile to that guest's record.

Search across centers

The redesigned appointment book search includes a Search across centers toggle that lets staff find guests who are registered at other centers in your organization.

  1. Open the guest search field in the appointment book.
  2. Turn on the Search across centers toggle.
  3. Type at least three characters of the guest's name, phone number, or email address.
  4. Results from all centers within the configured scope appear in the overlay.

The scope of cross-center search is configurable at the organization level under Configuration > Appointments > Personalization > Guest search. Administrators can set the scope to:

  • Organization (Search for guests across centers) β€” search returns guests from every center in the organization.
  • Zone (Search for guests across centers) β€” search is limited to centers in the same zone (region or business unit).

Individual centers can also enable or disable cross-center search as a default behavior using the Allow guest search across centers by default center-level setting. Ask your administrator which scope is configured for your center if you are unsure.

Legacy experience: Cross-center search is available only in the redesigned appointment book. The legacy appointment book searches the current center only.


Past searches

When the guest search overlay opens with no query typed, the redesigned appointment book displays your past searches β€” a list of guests you have recently looked up. This shortens repeat lookups when a guest returns or when you need to switch back to a profile you were viewing.

  • The list shows your most recent searches (up to ten entries).
  • Selecting an entry opens the guest's profile or pre-fills the search field with that query.
  • The list is per-user and persists across sessions on the same device.

Legacy experience: Past searches is available only in the redesigned appointment book.


Apply search filters

You can apply filters to narrow guest search results. The redesigned filter panel includes the following filters:

Filter What it does
Center Limit results to guests registered at one or more selected centers (used in combination with Search across centers).
Guest category Limit results to guests assigned a particular category (for example, VIP, lead, member).
Has active membership Show only guests who currently have an active membership.
Has active package Show only guests who currently have an active package.
Has active gift card Show only guests who currently have an active gift card balance.

To apply filters:

  1. Open the search filter view from the search overlay.
  2. Select one or more filters and confirm.
  3. The search results update to match your filter selections.

Legacy experience: The legacy appointment book uses a different, narrower filter set. Filter names and behavior in the redesigned panel do not match the legacy panel one-to-one.


Read a guest search result

Each guest search result in the redesigned overlay shows:

  • Guest name with any salutation or preferred-name formatting your organization has configured.
  • Phone number (masked according to your privacy settings).
  • Email address (masked according to your privacy settings) β€” the redesigned overlay shows email as a secondary line under the name and phone, making it easier to disambiguate guests with similar names.

If a result row appears truncated, hover over the row to see the full name, phone, and email.


Start a booking from a search result

In the redesigned appointment book search, each guest result includes an inline action that lets you initiate a booking for that guest without closing the search overlay first.

  1. Type at least three characters and locate the guest in the result overlay.
  2. On the guest's row, select the inline action that initiates a booking from the search result.
  3. The booking wizard opens with the guest pre-selected. Continue with service, provider, and time-slot selection.

Legacy experience: The legacy appointment book does not offer an inline booking action on a guest search result. Open the guest profile first, then start the booking from the appointment book toolbar.


Create a new guest

When a guest does not exist in the system, you can create a new record from the guest search interface or the booking wizard.

Required and optional fields

A new guest record requires the following minimum information:

  • First name β€” required
  • Last name β€” required
  • Phone number or email address β€” at least one contact method is required

Beyond these minimums, the new guest form supports additional optional fields:

  • Additional phone numbers (home, work) with country code selection
  • Date of birth
  • Gender
  • Salutation (when salutations are enabled for your organization)
  • Preferred pronouns (when preferred pronouns are enabled for your organization)
  • Address information
  • Referral source
  • Message preferences (email, SMS, push notification opt-in/opt-out)
  • Relationships (family members or linked guests)

An administrator configures which fields are mandatory at the organization scope through Configure guest settings. The form dynamically shows mandatory field indicators based on your organization's configuration. Note that mandatory-field enforcement at the time of booking applies to in-store bookings made from the Appointment Book bottom panel and does not affect online bookings through the Webstore or the Consumer Mobile App.

Important β€” TCPA compliance for marketing messages: When you set message preferences for a new guest, you MUST obtain explicit guest approval before opting them in to marketing emails, SMS, or push notifications. This is a U.S. Telephone Consumer Protection Act (TCPA) requirement and applies regardless of the guest's other preferences. Confirm verbally with the guest, then set the preferences as they have agreed. Do not opt a guest in to marketing without their explicit consent.

Note: The loyalty SMS and email opt-in is set to off (unchecked) by default for all new guests. Staff must explicitly enable it when the guest provides consent.

Referral source

The Referral source field on the new guest form records how the guest found your center. You can also update this field after the guest record is saved β€” it is editable on the guest profile's General tab. Capturing the referral source at creation time is the most reliable approach because staff and guests are engaged in that conversation at the moment of sign-up.

Note: Once a referring guest has been recorded on the profile, the referral source field becomes read-only and can no longer be changed, regardless of permissions.

The Referral History tab in the guest profile is read-only β€” it shows a history of referral activity for that guest but cannot be edited directly. To manage the referral categories that appear in the referral source dropdown, contact your administrator.

Create a guest from the appointment book

  1. From the Appointment Book, click the guest search field.
  2. Click the add guest icon next to the search input. (In the redesigned experience, this is an icon in the search bar β€” there is no "New Guest" button label.)
  3. The new guest creation form opens. It shows every field: First name, Last name and the fields your organization requires appear under Required details, and every other field appears under Optional details, which is collapsed when the form opens.
  4. Fill in the required fields: first name, last name, and at least one contact method.
  5. Expand Optional details and fill in optional fields as needed.
  6. Optionally add family relationships by navigating to the relationships screen within the form.
  7. Configure message preferences (email, SMS, push notification opt-in/opt-out). Per the TCPA note above, capture explicit guest approval before opting in to marketing channels. The loyalty SMS and email opt-in is off by default β€” enable it only if the guest consents.
  8. Click Save.

The system validates all mandatory fields before saving. If any required field is missing, an inline error message displays next to the affected field.

Legacy experience: In the legacy appointment book, the equivalent action is a labelled New Guest button rather than an icon in the search bar. It opens a short dialog, not the full form β€” the dialog does not have the same fields or the same validation as the redesigned form.

  • What it collects. Mobile, First, Last, Code, Email, Gender and Referral. Ref. By appears only when the referral source selected is the one for guest referrals. Salutation and Preferred Pronoun appear when those features are enabled; Room appears at hotel centers; the guest additional fields appear only when the organization requires them; and a minor checkbox appears when a minor age is configured.
  • What it does not collect. The dialog has no field for birthday, street address, city, state, country, nationality, postal code or primary employee, and no message preferences or relationships. Staff complete those on the guest profile after the guest is created.
  • What it checks before it creates the guest. Mobile (unless Mobile number is optional is on), first name and last name; gender, when the organization requires it; and referral source, email and the guest additional fields, when Show alert if required fields are missing when creating guest profile is on and the organization lists them as required. Other required fields are not checked at creation, so when Block payment if required fields are missing lists them, payment is blocked until they are added to the profile.

Create a guest from the booking wizard

When you are in the middle of creating an appointment and the guest does not exist:

  1. In the guest selection step of the booking wizard, search for the guest.
  2. When the search returns no results, select the option to create a new guest.
  3. Complete the form and click Save. (The TCPA note above applies here too β€” capture explicit consent before opting in to marketing.)
  4. The system creates the guest and automatically selects them for the appointment you are booking.
  5. Continue with the remaining booking wizard steps.

Duplicate detection

When you submit a new guest record, the system automatically checks for existing guests with the same phone number or email address. If a potential duplicate is found, the system displays a warning and gives you the option to:

  • Use the existing record β€” cancel creation and open the existing guest's profile instead.
  • Create anyway β€” proceed with creating the new record despite the potential duplicate.

Note: The duplicate warning matches only on phone number and email address. It does not catch a record created with a mistyped name, phone number or email address. See Troubleshooting for how to find and merge such a record.


Guest list features

The redesigned guest list in the appointment book includes features that help staff identify and act on guest records more quickly:

  • Advanced filters β€” use the filter panel above the guest list to filter by criteria such as Center, Guest category, Has active membership, Has active package, and Has active gift card.
  • Visual cues for missing required data β€” guest rows with missing required fields (such as an email address or phone number) are highlighted visually to prompt staff to complete the guest record.
  • AI Summary β€” the redesigned guest list includes an AI-generated summary column that provides a brief overview of the guest's visit history and engagement patterns. This column appears in the redesigned appointment book guest list when the AI Summary feature is enabled for your organization.

Note: Inline editing of guest record fields directly from the guest list is not available in the current guest profile. To edit guest details, open the guest profile and navigate to the General / Overview tab.


Merge duplicate guest records

When your organization has the same guest registered under two or more records (for example, a guest used different phone numbers or email addresses on different visits), you can merge the duplicate records into a single profile.

This action is available in the current guest profile via the Manage Duplicates option in the guest list or guest profile context menu.

How to merge duplicate records:

  1. From the Appointment Book, open the guest list and locate one of the duplicate guest records.
  2. Select Manage Duplicates from the guest row's action menu, or open the guest profile and look for the duplicate-management option.
  3. Zenoti identifies potential duplicates based on matching name, phone, or email. The system shows the candidate duplicate records.
  4. Review the proposed duplicate. Zenoti shows which data from each record will be preserved and which will be merged β€” confirm the merge is correct before proceeding.
  5. Select which record to keep as the primary record.
  6. Confirm the merge.

Important: A merge cannot be reversed. Once two guest records are merged, all data β€” appointments, memberships, packages, gift cards, loyalty points, invoices, and notes β€” is consolidated under the primary record. The secondary record is removed.

Note: After merging, the name, phone number, and email address of the kept (primary) record are retained. Confirm these details are correct on the kept profile after the merge completes.


Tips

  • Use phone number for fastest lookup. Phone number searches tend to return the fewest false matches, especially in organizations where guests share similar names. Start with phone when you have it.
  • Turn on Search across centers before typing. The Search across centers toggle must be on before you type your query β€” toggling it after a search has run does not automatically refresh results. Enable it first, then type.
  • Check past searches before typing. If you recently looked up a guest, their name appears in the past-searches list the moment you click the search field. Selecting from this list is faster than retyping the query.
  • Use filters to disambiguate common names. When a name search returns many results, apply the Has active membership or Guest category filter to narrow the list before scrolling.
  • Capture referral source at creation time. The referral source field is editable after saving a guest record, but capturing it at creation is the most reliable option because staff and the guest are already discussing how they found the center. Note that once a referring guest is recorded on the profile, the referral source field becomes read-only.

Troubleshooting

  • Search returns no results even though the guest exists. The search requires at least three characters and matches against name, phone number, and email address only. If you searched by guest code, that parameter is not supported in the redesigned appointment book. Try searching by the guest's phone number or email address instead. If the guest is registered at a different center, enable the Search across centers toggle and search again.

  • A guest's profile is confirmed reachable β€” it appears on an existing appointment or invoice β€” but search does not return the guest even with Search across centers enabled. Do not create a second guest profile. If possible, book from the existing appointment or invoice while the issue is being investigated. Contact Zenoti support with the guest's name and the center you searched from so the search record can be located.

  • A guest reports that a recent purchase such as a membership is missing from their profile, or that they cannot sign in. A second profile may have been created at checkout with a mistyped name, phone number or email address. The duplicate warning shown when creating a guest matches only phone number and email address, so it does not catch such a record. To find the record, do one of the following:

    • Open the guest's usual profile, select the merge option, and on the Merge Guests page search by part of the first or last name. The name search matches any part of the name, while phone and email match from the beginning.
    • On the Manage duplicates page, use Search with contains.

    Check the creation date shown for each record to find one created on the day of the sale. After you find the record, merge it into the profile the guest normally uses by starting the merge from that profile. Then confirm that the email address and mobile number on the kept profile are correct.

  • Mandatory fields are blocking a booking but the guest has no email address. The Block booking of appointment if any required fields are missing setting applies to in-store bookings from the Appointment Book bottom panel. If email is configured as a required field and the guest does not have one, either add a placeholder or ask your administrator to adjust the mandatory-field configuration in Configure guest settings. Online bookings through the Webstore or Consumer Mobile App are not affected by this setting.

  • The new guest form shows a duplicate warning for a guest I know is new. The duplicate check matches on phone number and email address. If another guest record already uses the same contact details (for example, a family member sharing a phone number), the warning appears. Review the existing record to confirm it is a different person, then select Create anyway to proceed.

  • Message preference toggles are grayed out on the new guest form. Your security role may not include permission to set marketing preferences. Contact your manager to confirm your role permissions, or ask them to set the preferences on the guest record after creation.


Was this article helpful?
Your feedback helps us improve our documentation.