RIXML Documentation

Keyword

RIXML 2.5 Element

Level OneRequired

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.

Source:level-one-2.5
Schema:RIXML-Common-2_5.xsd:1355

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

Where It Fits

Definition

Type
Namespacehttp://www.rixml.org/2017/9/RIXML
Min Occurs1
Max Occurs1
Content ModelText 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

SHOULD

Keywords should only be populated with terms that would help users locate relevant research products

best-practicecontent-quality

Semantic Relationships

Requires1 relationship

KeywordClassifications element must contain at least one Keyword child element

RIXML Level One Addendum v2.5, p.21Research.Product.Context.ProductClassifications.KeywordClassifications.Keyword