--- title: MetadataString date: 2023-01-07 nav: components-Core categories: [components, Core] tags: [MetadataString, Core] --- ## Overview **MetadataString** contains a typed list of values providing metadata information about its parent node. Further information about this specific Metadata* node may be provided by a single child Metadata* node with `containerField='metadata'.` The **MetadataString** node belongs to the [Core](/x_ite/components/overview/#core) component and requires at least support level **1,** its default container field is *value.* It is available from X3D version 3.0 or higher. ## Hierarchy ``` + X3DNode + MetadataString (X3DMetadataObject)* ``` \* Derived from multiple interfaces. {: .small } ## Fields | Type | Access Type | Name | Default Value | | ---- | ----------- | ---- | ------------- | | SFNode | [in, out] | [metadata](#fields-metadata) | NULL | | SFString | [in, out] | [name](#fields-name) | "" | | SFString | [in, out] | [reference](#fields-reference) | "" | | MFString | [in, out] | [value](#fields-value) | [ ] | {: .fields } ### SFNode [in, out] **metadata** NULL [X3DMetadataObject] {: #fields-metadata } Information about this node can be contained in a [MetadataBoolean](/x_ite/components/core/metadataboolean/), [MetadataDouble](/x_ite/components/core/metadatadouble/), [MetadataFloat](/x_ite/components/core/metadatafloat/), [MetadataInteger](/x_ite/components/core/metadatainteger/), **MetadataString** or [MetadataSet](/x_ite/components/core/metadataset/) node. #### Hint - [X3D Architecture 7.2.4 Metadata](https://www.web3d.org/specifications/X3Dv4/ISO-IEC19775-1v4-IS/Part01/components/core.html#Metadata) ### SFString [in, out] **name** "" {: #fields-name } Depending on the metadata vocabulary, the attribute *name* is usually required for metadata nodes. #### Hints - Well-defined names can simplify design and debugging through improved author understanding. - [X3D Scene Authoring Hints, Naming Conventions](https://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#NamingConventions) #### Warning - *name* field is not included if this instance is a USE node, in order to avoid potential mismatches. ### SFString [in, out] **reference** "" {: #fields-reference } Reference to the metadata standard or definition defining this particular metadata value. ### MFString [in, out] **value** [ ] {: #fields-value } The *value* attribute is a strictly typed data array providing relevant metadata information. #### Hint - Many XML tools substitute XML character references for special characters automatically if needed within an attribute *value* (such as & for & ampersand character, or " for " quotation-mark character). ## Advice ### Hints - Typically use `containerField='value'` if the parent node is [MetadataSet](/x_ite/components/core/metadataset/). - Explicitly defining containerField for Metadata nodes is always allowed and also unambiguous across each version of X3D. - [Each of the Metadata nodes are allowed as top-level root nodes in a scene, if doing that be sure to explicitly define `containerField='metadata'.`](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-DIS/Part01/concepts.html#Rootnodes) - If present, an IS statement is the first child within any other node. - An IS statement precedes any sibling Metadata* node, which in turn precedes any other sibling nodes. - Comments are not readable when a model file is loaded for viewing, but [WorldInfo](/x_ite/components/core/worldinfo/) and Metadata* nodes are persistent and inspectable at run time. - [X3D for Web Authors, Chapter 15, Metadata Information](https://www.web3d.org/x3d/content/examples/X3dForWebAuthors/Chapter15-Metadata/Chapter15-MetadataInformation.html) ### Warnings - Default `containerField='metadata'` in X3D 3 changed to default `containerField='value'` in X3D 4.0, allowing construction of much terser [MetadataSet](/x_ite/components/core/metadataset/) vocabulary structures. - Metadata nodes can only contain other Metadata nodes. ## Browser Compatibility | Castle Game Engine | FreeWRL | X_ITE X3D Browser | X3D-Edit | X3DOM | |--------------------|---------|-------------------|----------|-------| | | | | | | {: .browser-compatibility } ## See Also - [X3D Specification of MetadataString Node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/core.html#MetadataString)