Issuer

Overview

Issuer represents a company, government, agency, or other entity that issues securities discussed in a research product. It is the central element for identifying the corporate or sovereign subject of equity, credit, and fixed-income research, carrying identifiers, names, financial data, sector classifications, ratings, weightings, and associated securities (sources: data-dictionary-2.4 p.45, data-dictionary-2.5.1 p.48, user-guide-2.3.1 p.33). Issuer lives inside IssuerDetails within Context and may appear multiple times. The required issuerType (from IssuerTypeEnum) classifies the entity (Corporate, Agency, Government, etc.), while primaryIndicator distinguishes the main subject from secondary mentions — supporting workflows that route, filter, and categorise research by coverage universe (sources: user-guide-2.1 p.31, data-dictionary-2.5.1 p.48).

Usage

Use Issuer whenever a research product discusses a specific issuing entity. Multiple Issuer elements MAY appear inside IssuerDetails, optionally ordered via sequence for display purposes (sources: user-guide-2.1 p.31, user-guide-2.3.1 p.33). Required attributes: issuerType and primaryIndicator must always be present (sources: level-one-2.3.1 p.12, data-dictionary-2.5.1 p.48). Primary designation: Exactly one Issuer should normally be marked primary (primaryIndicator="Yes"); the rare exception is a merger report covering two companies equally. When ProductFocus is set to Issuer, at least one Issuer MUST be marked primary (sources: best-practices-guide p.19, user-guide-2.1 p.31, user-guide-2.3.1 p.33). Typical children: IssuerName (at least one required), IssuerID, IssuerFinancials, FinancialDates, SectorIndustry, SecurityDetails, Rating, Weighting, and ResourceLink (sources: data-dictionary-2.4 p.45, user-guide-2.3.1 p.33). Inclusion criteria: Only include issuers that are substantively discussed. Companies appearing solely in tables, charts, or brief mentions should not be tagged as Issuers, as this clutters search indexes and misleads consumers about content focus (sources: best-practices-guide p.20, data-dictionary-2.5.1 p.17).

Rules

• MUSTWhen IssuerDetails is present, it MUST contain at least one Issuer element.[RIXML Level One Addendum v2.2 p.17] [RIXML Level One Addendum v2.3 p.12] [RIXML Level One Addendum v2.3.1 p.12] [RIXML Level One Addendum v2.5 p.12]
• MUSTIssuer MUST specify both issuerType (from IssuerTypeEnum) and primaryIndicator.[RIXML Level One Addendum v2.3.1 p.12] [RIXML Research Data Dictionary v2.5.1 p.48] [RIXML Research Data Dictionary v2.4 p.45]
• MUSTIssuer MUST contain at least one IssuerName element with a nameType attribute.[RIXML Level One Addendum v2.3 p.13] [RIXML Level One Addendum v2.3.1 p.13] [RIXML Level One Addendum v2.4 p.13] [RIXML Level One Addendum v2.5 p.13]
• MUSTWhen ProductFocus is set to Issuer, at least one Issuer MUST have primaryIndicator="Yes".[RIXML User Guide v2.1 p.33] [RIXML User Guide v2.3.1 p.33] [RIXML Research Data Dictionary v2.4 p.45]
• MUSTEvery Security referenced in a research product MUST be attached to an Issuer element, since securities are always issued by an entity.[RIXML User Guide v2.2 p.37] [RIXML Research Data Dictionary v2.5.1 p.55] [RIXML Research Suite Data Dictionary v3.0 (DRAFT) p.51]↗
• SHOULDCompanies that are only mentioned briefly — for example appearing solely in tables or lists — SHOULD NOT be tagged as Issuer entries.[Best Practices for Publishing RIXML p.20] [RIXML Research Data Dictionary v2.5.1 p.17]
• SHOULDFor industry-overview reports, ProductFocus SHOULD be set to SectorIndustry and individual Issuer identifiers SHOULD be omitted, since the focus is the sector rather than specific companies.[RIXML Implementation Guide v2.5.1 p.23]
• INFORMATIVEIn Level One compliance, the Rating, FinancialDates, SectorIndustry, Weighting, and ResourceLink child elements of Issuer are not required (they may still be included without breaking Level One conformance, but Level One implementations are not expected to support them).[RIXML Level One Addendum v2.2 p.17] [RIXML Level One Addendum v2.3 p.12] [RIXML Level One Addendum v2.5 p.12]

Relationships

• child-ofIssuerDetails — Issuer is a required child of IssuerDetails; the container must hold at least one Issuer when present.
• requiresIssuerName — Each Issuer requires at least one IssuerName child to identify the entity by name.
• constrainsSecurity — Securities are always issued by entities, so any Security in a product must be attached to an Issuer.
• qualifiesProductFocus — When ProductFocus equals Issuer, at least one Issuer must be marked primary; conversely when ProductFocus is SectorIndustry, individual issuer identifiers should generally be omitted.
• qualifiesSectorIndustry — SectorIndustry classifications appearing under an Issuer categorise that issuer for industry-based discovery and filtering.
• referencesResourceLink — ResourceLink can associate a particular Issuer with its corresponding XBRL or other resource when multiple resources are incorporated.
• qualifiesIssuer.primaryIndicator — The primaryIndicator attribute distinguishes the main focus company from other entities mentioned in multi-company reports.
• constrained-byIssuerTypeEnum — issuerType is constrained to values from IssuerTypeEnum (e.g. Corporate, Agency, Government).