> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zuper.co/llms.txt
> Use this file to discover all available pages before exploring further.
# Configuring Customer-Contact Settings
Customer and contact settings control how Zuper stores, displays, and manages the people and businesses you work with. From here, you decide which fields are required, who on your team can create or edit records, how billing cycles work, and when automated reminders go out. Getting these settings right saves your team time every day and keeps your customer data consistent across jobs, invoices, and reports.
**Navigation**: *Settings -> Modules -> Customers-Contacts - > Customers-Contacts General Settings*
## **Customer-contact General settings**
General settings control the core behavior of every customer and contact record in Zuper. Use these toggles to set up unique identifiers, debt alerts, payment options, and portal access before your team starts adding records.
Select the “**Settings**” module from the left panel. Under the “**Modules**,” choose the “**Customer/Contact**.” Select the “**Customer/Contact General Settings**.”
**Select a unique field for customer/contact**\
Choose the field Zuper uses to identify each customer or contact record uniquely. This prevents duplicate records and helps your team find the right customer quickly.
**Show a bad debt alert upon choosing a customer/contact**\
Toggle to **Yes** to display a warning when a customer with an outstanding bad debt balance is selected on a job or invoice. Toggle to **No** to turn off this alert.
Enable this setting if your team regularly works with customers who have overdue balances. The alert appears at the point of selection, so your team can take action before work begins.
**Allow payment card on file**\
Toggle to **Yes** to let your team store a customer's payment card against their record. Toggle to **No** to turn off this option.
**Enable billing cycle**\
Toggle to **Yes** to activate billing cycle functionality for customers and contacts. Toggle to **No** to turn it off.
**Does customer/contact need an account manager**\
Toggle to **Yes** to allow an account manager to be assigned to each customer or contact record. Toggle to **No** to remove this option.
**Enforce geo-location in address**\
Toggle to **Yes** to require a verified geo-location when an address is entered on a customer or contact record. Toggle to **No** to allow addresses without location verification.
**Enable portal access by default**\
Toggle to **Yes** to automatically grant new customers and contacts access to your customer portal when their record is created. Toggle to **No** to require manual setup of portal access.
Lead source tracking lets you record where each new customer or job originates — for example, a website form, a phone call, or a referral. When this setting is on, the **Lead Source** field appears on customer, contact, and job records, and becomes available in filters, reports, and dashboards.
**Navigation**: *Settings → Modules → Customer/Contact → Customer/Contact General Settings*
**Track lead source**\
Toggle to **Yes** to enable lead source tracking for new and existing customers and contacts. Toggle to **No** to turn off this field across all records.
You must also create individual lead sources before your team can select them on records. See [Lead sources](#lead-sources) below for steps to add sources.
Select **Save** at the top right of the page to apply your changes.
[**Automatically create property upon customer/contact creation**](https://docs.zuper.co/Client/Contact/Create_contact#auto-create-property)\
Toggle to **Yes** to have Zuper automatically create a linked property record each time a new contact is created. Toggle to **No** to turn off automatic property creation.
This setting must be enabled by your administrator. When it is on, every new contact generates a corresponding property record without any additional steps from your team — useful if your business always associates a service address with each contact.
Click **Save** in the top-right corner.
## **Access / Permissions**
Access and permissions settings control what team leaders and field executives can see and do within the Customers/Contacts module. Review these settings carefully — they affect what your field team can access on the mobile app.
**Navigation**: *Settings → Modules → Customer/Contact → Customer/Contact General Settings*
Configure the following options:
**Can team leader view all customers/contacts**\
Toggle to **Yes** to give team leaders visibility of all customer and contact records. Toggle to **No** to restrict their view.
**Can field executive create new customer/contact**\
Toggle to **Yes** to allow field executives to add new customer and contact records from the mobile app. Toggle to **No** to prevent this.
**Can field executive edit customer/contact details**\
Toggle to **Yes** to allow field executives to update existing customer and contact records. Toggle to **No** to make records read-only for field executives.
**Can field executive view all customers/contacts**\
Toggle to **Yes** to give field executives access to all customer and contact records. Toggle to **No** to limit their visibility.
**Does field executive require facial authentication to view customers/contacts**\
Toggle to **Yes** to require field executives to complete facial authentication before viewing customer or contact records. Toggle to **No** to remove this requirement.
**Can field executive view customers/contacts without punching in**\
Toggle to **Yes** to allow field executives to view records before they punch in to a shift. Toggle to **No** to require a punch-in before access is granted.
Select **Save** at the top right of the page to apply your changes.
Lead sources are the specific channels you want to track — Website, Phone Call, Instagram, or Referral. Once you create a lead source here, your team can select it on customer, contact, and job records. Lead sources feed into your filters, dashboards, and reports, giving you a clear view of which channels bring in the most business.
**Navigation**: *Settings → Modules → Customer/Contact → Lead Sources*
### Add a lead source
1. Select **Settings** from the left navigation panel.
2. Under **Modules**, select **Customer/Contact**.
3. Select **Lead Sources**.
4. Select + New Source.
5. Enter the source name in the field provided.
Select Create. The new lead source appears in the list and is immediately available for selection on customer, contact, and job records.
## **Customer/contact category**
Categories let you group customers and contacts by type — for example, Residential, Commercial, or VIP. Each category can carry its own service level agreement (SLA) duration, so Zuper can track whether jobs for that group are completed on time.
**Navigation**: *Settings → Modules → Customer/Contact → Customer/Contact Category*
1. Select **Settings** from the left navigation panel.
2. Under **Modules**, select **Customer/Contact**.
3. Select **Customer/Contact Category**.
4. Select **+ New Category**.
A dialog box appears. Enter the following details:
* **Category name** *(required)*: Enter a name for the category.
* **SLA duration**: Set the expected time to complete service for customers in this category. Enter a value in days, hours, and minutes.
* **Category description**: Enter a brief description of the type of customers or contacts that belong to this category.
6. Select **Create**. The new category appears in the list and is available for selection on customer and contact records.
Fields marked with an asterisk (\*) are required. You cannot create a category without entering a category name.
## **Billing frequency**
1. Select **Settings** from the left navigation panel.
2. Under **Modules**, select **Customer/Contact**.
3. Select **Billing Frequency**.
4. Select **+ New Billing Frequency**.
5. Enter the following details:
* **Billing frequency name**: Enter a name for this frequency — for example, Monthly or Quarterly.
* **Frequency type**: Select the type that applies.
* **Billing frequency period**: Enter the number of days in the billing period.
3. Enter the billing frequency, choose the frequency type, and the billing frequency period (in days).
Click “**Create**” to create the billing frequency.
The **Enable Billing Cycle** toggle in [General Settings](#customer-contact-general-settings) must be turned on before billing frequencies appear on customer and contact records.
## **Customers-contacts custom fields**
**Navigation**: Settings -> Modules -> Customer-Contact -> Customer-Contact Custom Fields
1. Select the "**Settings**" module from the left panel. Under the "**Modules**," choose the " **Customer-Contact.**" Select the "**Customer-Contact Custom Fields**."
Custom fields let you capture information about customers and contacts that Zuper does not collect by default — for example, a preferred contact time, a contract reference number, or a property type. You build custom fields by dragging field types from the right panel onto the form layout.
**Navigation**: *Settings → Modules → Customer/Contact → Customer/Contact Custom Fields*
### Add custom fields
1. Select **Settings** from the left navigation panel.
2. Under **Modules**, select **Customer/Contact**.
3. Select **Customer/Contact Custom Fields**.
4. Drag a field type from the right panel onto the form layout. The following field types are available:
**Text**
* **Single-line input**: Captures a single line of free text.
* **Multi-line input**: Captures multiple lines of free text — useful for notes or descriptions. **Date**
* **Date input**: Lets the user select a date from a calendar.
* **Time input**: Lets the user select a specific time.
* **Date and time input**: Lets the user select both a date and a time together. **Selection**
* **Single-selection**: Displays radio buttons where only one option can be chosen.
* **Multi-selection**: Displays checkboxes where one or more options can be chosen.
* **Drop-down**: Displays a drop-down list of options. **Media**
* **Upload**: Allows a file to be attached to the record. **Miscellaneous**
* **Look up**: Lets the user search for and select a product from the Parts and Services module.
### Control field behavior
After you add a field, you can adjust how it behaves using the following options:
| Option | What it does |
| -------------------------------------- | ------------------------------------------------------------------------ |
| **Mark as required field** | Makes the field mandatory before a record can be saved. |
| **Mark as read only** | Displays the field value but prevents users from editing it. |
| **Mark as hidden field** | Hides the field from all users. It does not appear on the form. |
| **Hide to field executive/technician** | Hides the field from field executives and technicians on the mobile app. |
5. Select **Create New** to save the custom field group.
Use the **Mark as required field** option for any information your team must collect on every new record. This keeps your data complete from the start.
## **Customer/contact reminder**
Reminders are automated messages sent to customers or your team at a set time before or after a job event. Use them to reduce no-shows, prompt action, or keep customers informed without manual follow-up.
**Navigation**: *Settings -> Modules -> Customer-Contact -> Customer-Contact Custom Notifications*
1. Select the “**Settings**” module from the left panel. Under the “**Modules**,” click “**Customer/Contact Notifications**.”
2. Click “**+ New Reminder**.”
3. Fill in the reminder details
* Reminder Name: Enter a name for the reminder.
* Job Category: Select the job category.
* Notification Type: Choose the type of notification.
* Remind Type: Select the reminder type.
* Remind At / Before: Set a specific time for the reminder.
* SMS / Email Body: Enter the message content. Use the Available Components dropdown to insert dynamic fields, such as customer fields or job details (e.g., "The scheduled job starts at...").
* Notify for Unassigned Jobs: Check this box to receive a reminder to apply.
Click “**Save Reminder**” to save the reminder.
## **Customer/contact alerts**
1. Select the “**Settings**” module from the left panel. Under the “**Modules**,” click “**Customer/Contact Notifications**.”
2. Click “**+ New Notification**.”
3. Enter the following details:
* **Notification name**: Enter a clear, descriptive name for the alert — for example, "Job completed notification."
* **Notification type**: Select whether the alert is sent by SMS, email, or both.
* **Job category**: Select the job category this alert applies to.
* **Job status**: Select the job status that triggers this alert — for example, Completed or On My Way.
* **SMS/email body**: Enter the message to be sent. Select the **Available components** drop-down to insert dynamic fields and personalize the message automatically.
Click “**Save Notification**” to set the notification.
Click “**Save Reminder**” to save the alert.