About Contacts

When a new visitor first shares some of their contact information with a site, they're added to the site's contact list. Once that happens, their details are available through the Contacts APIs.

Some examples of how a person can become a contact are:

• A site visitor fills in a form with their contact details.
• A site visitor signs up as a member of the site.
• A site collaborator imports a contact or adds a contact manually.
• A 3rd-party app creates a contact with the Contacts API.

Site collaborators can use the contact list to manage their contacts' information. Learn more about how site collaborators can manage their contact list.

With the Contacts APIs, you can:

• Manage site contacts
• Manage contact labels
• Manage extended field definitions

Terminology

• Extended fields: Additional properties that store additional contact information. A contact's extended field data is available in the contact object under info.extendedFields. Extended field definitions can be created and managed with the Extended Fields API.

  There are 2 types of extended fields:

  • System fields: Extended fields added by Wix apps. System fields often enrich contacts with data from Wix apps, such as Wix Stores or Wix Members. System fields cannot be renamed and are typically read-only.
  • Custom fields: Extended fields added by site collaborators or 3rd-party apps. Custom fields can be renamed, and their data can be written by any site collaborators or 3rd-party app.

• Labels: Tags that help site contributors categorize and organize their contacts. Labels can be system-defined or user-defined. You can manage a site's labels through the Labels API. A contact's assigned labels are available in the contact object under info.labelKeys.