The Extended Fields API provides functionality for creating and managing extended field definitions. Extended fields enable you to retrieve and store specific information relevant to your site. Basic fields, such as name, email, and phone, are stored in the contact's default properties. Additional custom contact properties are stored in extended fields.
With the Extended Fields API, you can:
- Create a new extended field.
- Delete an extended field.
- Update an extended field by renaming its display name.
- Query extended fields.
It is important to note the following points before you begin to code:
- When you create a new extended field, it becomes available to use for all contacts. The field is blank by default.
- Possible data types of extended fields include:
- Extended fields are represented as key-value pairs in the contact's object in
info.extendedfields. To manage the extended fields of an individual contact, use the Contacts API.
- Extended field: A customized field that can store additional information for a contact. A contact’s extended field data is available in the
contact object under info.extendedFields. There are 2 types of extended fields:
- System field: An extended field 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 field: An extended field added by site admins or 3rd-party apps. Custom fields can be renamed, and their data can be written by any site admin or 3rd-party app.