<doc>
	<legacy_id></legacy_id>
	<name>metadata</name>
	<type>property</type>

	<syntax>
		<example>set the metadata of <i>fieldChunk</i> to <i>string</i></example>
	</syntax>

	<synonyms>
	</synonyms>

	<summary>The <b>metadata</b> property of a field chunk specifies additional information stored with the field chunk but not visible to the user.</summary>

	<examples>
<example>set the metadata of word 6 of field 1 to &quot;extra information hidden from the user&quot;</example>
<example>get the metadata of char 1 to 100 of field 1</example>
<example>set the metadata of line 3 field "description" to &quot;extra information&quot;</example>
<example><p>put &quot;ben is 5 years old&quot; into field 1</p><p>set the metadata of word 1 of field 1 to &quot;noun&quot;</p><p>repeat with x = 1 to the number of words of field 1</p><p>   if the metadata of word x of field 1 is &quot;noun&quot; then </p><p>      put toUpper(word x of field 1) into word x of field 1</p><p>   end if</p><p>end repeat</p></example>
	</examples>

	<history>
		<introduced version="5.5">Added.</introduced>
    <changed version="6.0">Changed</changed>
		<deprecated version=""></deprecated>
		<removed version=""></removed>
		
	</history>

	<objects>
		<field/>
	</objects>

	<platforms>
		<mac/>
		<windows/>
		<linux/>
		<ios/>
		<android/>
	</platforms>

	<classes>
		<desktop/>
		<server/>
		<web/>
		<mobile/>
	</classes>

	<security>
	</security>


	<classification>
		<category>Text and Data Processing</category>
	</classification>

	<references>
		<property tag="styledText">styledText Property</property>
		<property tag="flagged">flagged Property</property>
	</references>

	<description>
	<overview>Use the <b>metadata</b> property to store additional information in a field that is not visible to a user. Metadata can be specified for any field chunk; char, word and line as well as ranges (e.g. word 2 to 5).</overview>

		<parameters>
  <parameter>
    <name>string</name>
    <description>A string of text.</description>
  </parameter>		</parameters>

	<value></value>
	<comments><p>The ability to add metadata at the paragraph level was added in version 6.0. Like metadata at the char level, you can now 'set the metadata of line ... of ...' and it will be attached to the paragraph, a level above the char properties. This means if you want to set the metadata on the char level for a whole line you must do 'set the metadata of char 1 to -1 of line .. of ...', rather than just 'of line'.</p></comments>
	</description>
</doc>