ContactInfo
RIXML 2.5 Element
Comprehensive contact information container for organizations, groups, or persons involved in research creation. Contains required nature attribute (business or personal from ContactInfoNatureEnum), optional purpose attribute (ContactInfoPurposeEnum for intended use), and optional Description field for additional details. Must include at least one contact method.
Usage
Can appear multiple times within Organization, PersonGroup, or Person elements. At least one of Address, Email, Phone, Website, or InstantMessenger must be provided. Purpose attribute describes intended use like participation, replay, registration, etc.
Business Context
Essential for enabling client communication and research distribution workflows. Supports various contact scenarios including event registration, question/answer sessions, and general business communication, facilitating effective research client relationships.
Specification Guide
Overview
ContactInfo is a reusable container that aggregates one or more contact methods — typically Address, Email, Phone, Website, and (prior to v3.0) InstantMessenger — for an Organization, PersonGroup, or Person involved in the production or distribution of research. It classifies the contact details as business or personal through the required nature attribute and may further qualify their intended use via the optional purpose attribute (sources: data-dictionary-2.4 p.31, data-dictionary-2.5.1 p.33, user-guide-2.2 p.20). The element exists to give research consumers a standardised way to reach the authors, teams, and firms behind a research product for follow-up, client servicing, event registration, and relationship management.
Usage
ContactInfo is optional in most contexts and may appear multiple times to capture distinct contact scenarios (for example, separate business and personal entries, or different purposes such as registration vs. replay). In RIXML 2.x it is typically nested inside Organization, PersonGroup, Person, and event-related elements such as EventVenue, EventHost, and RegistrationInformation (sources: data-dictionary-2.4 p.31, user-guide-2.2 p.20, implementation-guide-2.5.1 p.26). The required nature attribute (drawn from ContactInfoNatureEnum) must be set to indicate a business or personal context. The optional purpose attribute (drawn from ContactInfoPurposeEnum) further describes the intended use, such as participation, registration, or replay [data-dictionary-2.5.1 p.33]. Each ContactInfo must contain at least one contact method from Address, Email, Phone, Website, or InstantMessenger (sources: user-guide-2.1 p.20, user-guide-2.2 p.20, user-guide-2.3 p.20, data-dictionary-2.5.1 p.33). From RIXML 2.2 onwards an optional Description child element provides free-text context beyond the purpose enumeration [user-guide-2.2 p.20]. In the v3.0 draft the structure is streamlined: ContactInfo becomes a required child of a ContactInfoList container (multiples allowed), and the individual contact methods are grouped into dedicated list elements — AddressList, PhoneList, EmailList, and WebsiteList — that permit multiple entries of each type (sources: data-dictionary-v3-draft p.28, meeting-2025-06 p.22).
Rules
- MUSTContactInfo MUST declare the nature attribute (business or personal) drawn from ContactInfoNatureEnum.[RIXML User Guide v2.1 p.20] [RIXML User Guide v2.2 p.20] [RIXML User Guide v2.3 p.20] [RIXML Research Data Dictionary v2.5.1 p.33]
- MUSTContactInfo MUST contain at least one contact-method child: Address, Email, Phone, Website, or (pre-v3) InstantMessenger.[RIXML User Guide v2.1 p.20] [RIXML User Guide v2.2 p.20] [RIXML Research Data Dictionary v2.4 p.31] [RIXML Research Data Dictionary v2.5.1 p.33]
- SHOULDpurpose SHOULD be supplied when the contact information has a specific intended use (such as participation, registration, or replay), using ContactInfoPurposeEnum.[RIXML Research Data Dictionary v2.5.1 p.33] [RIXML User Guide v2.2 p.20]
- SHOULDAuthor and analyst ContactInfo SHOULD include both Email and Phone so that research consumers can reach contributors through their preferred channel; Phone entries should carry an appropriate type (e.g. Voice, Fax).[Company Report (Advanced) Sample v2.4]↗ [Economics Report (Basic) Sample v2.4]↗ [Industry Report (Advanced) Sample v2.4]↗ [Morning Call Report (Advanced) Sample v2.4]↗
- INFORMATIVEContactInfo is not required by the Level One compliance profile when it appears under Organization, PersonGroup, or Person; documents that omit it from those contexts remain Level One compliant.[RIXML Level One Addendum v2.2 p.13] [RIXML Level One Addendum v2.5 p.6] [RIXML Level One Addendum v2.5 p.7] [RIXML Level One Addendum v2.5 p.8]
Relationships
- child-ofOrganization — ContactInfo may appear as a child of Organization to provide firm-level contact details.
- child-ofPersonGroup — ContactInfo may appear under PersonGroup to provide contact details for a research team.
- child-ofPerson — ContactInfo may appear under Person to expose contact channels for individual analysts and authors.
- child-ofEventVenue — ContactInfo may be attached to EventVenue to describe how to reach the venue.
- child-ofEventHost — ContactInfo may be attached to EventHost to identify host-side communication channels.
- child-ofRegistrationInformation — ContactInfo may appear within RegistrationInformation to provide registration-related contact channels for events.
- containsAddress — ContactInfo aggregates one or more Address entries; in v3.0 these are wrapped in an AddressList container.
- containsEmail — ContactInfo aggregates one or more Email entries; in v3.0 these are wrapped in an EmailList container.
- containsPhone — ContactInfo aggregates one or more Phone entries; in v3.0 these are wrapped in a PhoneList container and country codes move inside the phone number content.
- containsWebsite — ContactInfo aggregates one or more Website entries; in v3.0 these are wrapped in a WebsiteList container.
- containsInstantMessenger — Through RIXML 2.5, ContactInfo may contain InstantMessenger child entries; this child has been removed in the v3.0 draft.
- uses-enumContactInfoNatureEnum — The required nature attribute draws its values from ContactInfoNatureEnum (business or personal).
- uses-enumContactInfoPurposeEnum — The optional purpose attribute draws its values from ContactInfoPurposeEnum to indicate the intended use of the contact information.
Where It Fits
Canonical Path
Definition
| Type | ContactInfoType |
| Namespace | http://www.rixml.org/2017/9/RIXML |
| Min Occurs | 1 |
| Max Occurs | 1 |
Attributes
Children
InstantMessengerstring0..unbounded |
optionalSince 2.1 |
Emailstring0..unbounded |
optionalSince 2.1 |
Phone(complex)0..unbounded |
optionalSince 2.1 |
Website(complex)0..unbounded |
optionalSince 2.1 |
Address(complex)0..1 |
optionalSince 2.1 |
Descriptionstring0..1 |
A brief description of the contact information can be included here, if desired. This element is intended to pick up where the purpose attribute leaves off. It offers the ability to provide more detail. optionalSince 2.1 |
Example
<ContactInfo nature="Value" />Version History
Unchanged since introduction in RIXML 2.1
RIXML 2.1–2.3: ContactInfo is established as a reusable aggregation container under Organization, PersonGroup, and Person with required nature and optional purpose attributes, accepting Address, Email, Phone, Website, and InstantMessenger children (sources: user-guide-2.1 p.20, user-guide-2.2 p.20, user-guide-2.3 p.20). From 2.2 an optional Description child element is available for free-text context [user-guide-2.2 p.20]. RIXML 2.4–2.5.1: The element's role and content model remain stable, with additional permitted parents including EventVenue, EventHost, and RegistrationInformation for event-driven scenarios (sources: data-dictionary-2.4 p.31, data-dictionary-2.5.1 p.33, implementation-guide-2.5.1 p.26). RIXML 3.0 (draft): The legacy ContactInfo *package* is retired and replaced by a streamlined ContactInfo *element* nested in a ContactInfoList container (multiples allowed) (sources: meeting-2025-01 p.35, meeting-2025-06 p.22, data-dictionary-v3-draft p.28). Individual contact methods move into dedicated list wrappers — AddressList, PhoneList, EmailList, and WebsiteList — to support multiple entries per type. The InstantMessenger child is removed, and phone country codes are now encoded inline within the phone number content rather than as a separate element [meeting-2025-01 p.35].
Design Decisions
Level One excludes ContactInfo elements as children of Organization
To simplify the Level One implementation by removing detailed contact information
RIXML Level One Addendum v2.5, p.6
Level One excludes ContactInfo elements inside PersonGroup
To maintain simplicity in Level One implementations by removing detailed contact information for person groups
RIXML Level One Addendum v2.5, p.7
Level One excludes ContactInfo elements inside Person
To maintain simplicity in Level One implementations by removing detailed contact information for individual persons
RIXML Level One Addendum v2.5, p.8
Semantic Relationships
Broadens1 relationship
The ContactInfo Description element extends beyond the purpose attribute to provide more detailed contact information
RIXML Research Data Dictionary v2.5.1, p.34— Elements and Attributes: