Keyword
RIXML 2.5 Element
Contains individual search terms or phrases that describe research content themes, companies, products, or concepts. Stores free-text values without predefined vocabulary constraints.
Free-text keywords relevant to the product, which the consumers may want to search on. There is no maximum length, but should only be populated with terms that would help users locate relevant research products. These keywords, like all other metadata, will be in the language of the Research.Language.
Usage
Include one or more Keyword elements within KeywordClassifications to enable content searchability. Each element holds a single term or phrase relevant to the research topic.
Business Context
Powers search and discovery functionality in research platforms, allowing users to find content through intuitive keyword matching beyond formal classification schemes.
Specification Guide
Overview
Keyword holds a single free-text search term or phrase that describes the content of a research product, enabling discovery beyond the formal taxonomies provided by structured classification elements. It sits inside KeywordClassifications (within ProductClassifications under Context) and supplements sector, subject, and other coded classifications with flexible, publisher-defined tags such as company names, product names, themes, or concepts (sources: data-dictionary-2.5.1 p.53, level-one-2.5 p.20).
Usage
Place one or more Keyword elements inside a KeywordClassifications container; each element carries a single term or phrase as its string value. There is no maximum length restriction, but publishers should populate keywords judiciously — only with terms that genuinely help consumers locate the research (sources: data-dictionary-2.5.1 p.53, user-guide-2.2 p.36). Keyword content should be written in the same language as declared by the language attribute on the enclosing Research document (sources: user-guide-2.1 p.35, data-dictionary-2.4 p.51). Multiple Keyword elements are the normal pattern, with each tagging a different aspect (company, product, theme, geography, etc.) of the research [level-one-2.5 p.20]. Cardinality within KeywordClassifications is one-or-more from RIXML 2.2 onward (sources: level-one-2.2 p.26, level-one-2.5 p.21). In the earlier 2.1 user guide it is described as an optional repeatable element [user-guide-2.1 p.35]; from 2.2 the parent KeywordClassifications requires at least one Keyword child to be valid.
Rules
- SHOULDKeyword should only be populated with terms that genuinely help users locate relevant research products; avoid excessive or irrelevant keywords that dilute search quality.[RIXML Research Data Dictionary v2.5.1 p.53] [RIXML User Guide v2.1 p.35] [RIXML User Guide v2.2 p.36]
- SHOULDKeyword content should be in the same language as the language declared by language on the enclosing Research document.[RIXML User Guide v2.1 p.35] [RIXML User Guide v2.2 p.36] [RIXML Research Data Dictionary v2.4 p.51]
- MUSTWhen KeywordClassifications is present, it must contain at least one Keyword child element.[RIXML Level One Addendum v2.2 p.26] [RIXML Level One Addendum v2.5 p.21]
Relationships
- child-ofKeywordClassifications — Keyword is a required repeatable child of KeywordClassifications; the parent must contain at least one Keyword to be valid.
- descendant-ofProductClassifications — Keyword appears under ProductClassifications via its KeywordClassifications container, contributing to the overall classification metadata for the product.
- language-aligned-withResearch — The text value of Keyword is expected to be in the language declared by language.
Where It Fits
Canonical Path
Definition
| Type | |
| Namespace | http://www.rixml.org/2017/9/RIXML |
| Min Occurs | 1 |
| Max Occurs | 1 |
| Content Model | Text content (string) |
Attributes
No attributes defined for this element
Children
Contains text content (type: string)
This element's value is its text content. Attributes provide additional context.
Example
<Keyword>ABC-123</Keyword>Version History
Unchanged since introduction in RIXML 2.1
Keyword is present throughout the RIXML 2.x line. In 2.1 it is described as an optional repeatable element within KeywordClassifications [user-guide-2.1 p.35]. From 2.2 onward the schema treats Keyword as required with one-or-more cardinality whenever KeywordClassifications is present (sources: level-one-2.2 p.26, level-one-2.5 p.21). The semantics, free-text nature, and language-alignment guidance remain stable through 2.3.1, 2.4, and 2.5 (sources: data-dictionary-2.4 p.51, data-dictionary-2.5.1 p.53). In the RIXML 3.0 draft, Keyword is superseded by a new element, ExpectedSearchTerm, as part of an effort to make findability semantics more explicit [data-dictionary-v3-draft p.77].
Business Rules
Keywords should only be populated with terms that would help users locate relevant research products
Semantic Relationships
Requires1 relationship
KeywordClassifications element must contain at least one Keyword child element
RIXML Level One Addendum v2.5, p.21— Research.Product.Context.ProductClassifications.KeywordClassifications.Keyword