narrative
=========

``iati-activities/iati-activity/policy-marker/narrative``

This is the reference page for the XML element ``narrative``. 

.. index::
  single: narrative

Definition
~~~~~~~~~~


A description of the policy marker. This MUST ONLY be
used if vocabulary is 99 (the reporting
organisation's own marker vocabulary). May be repeated
for multiple languages.



Rules
~~~~~

The text in this element must be of type xsd:string.








This element may occur any number of times.







``narrative`` must be present if @vocabulary='99'





Attributes
~~~~~~~~~~


.. _iati-activities/iati-activity/policy-marker/narrative/.xml:lang:

@xml:lang
  A code specifying the language of text in this element. It is recommended that wherever possible only codes from ISO 639-1 are used. If not present, the default language is assumed.

  This value should be on the :doc:`Language codelist </codelists/Language>`.



  





Example Usage
~~~~~~~~~~~~~
The ``narrative`` child element can be used to declare freetext for the ``policy-marker`` element.

| The ``narrative`` element should be used only when the *99* (*Reporting Organisation*) *PolicyMarkerVocabulary* is declared.

.. code-block:: xml

	<policy-marker vocabulary="99" code="10" significance="3">
		<narrative>Policy Marker Text</narrative>
	</policy-marker>

| The ``narrative`` element can be repeated for any language additional to the default language set in ``iati-activity``, by using the ``@xml:lang`` attribute.  Example not shown.

Changelog
~~~~~~~~~

2.01
^^^^
| The ``narrative`` element was introduced in 2.01.


Developer tools
~~~~~~~~~~~~~~~

Find the source of this documentation on github:

* `Schema <https://github.com/IATI/IATI-Schemas/blob/version-2.03/iati-common.xsd#L27>`_
* `Extra Documentation <https://github.com/IATI/IATI-Extra-Documentation/blob/version-2.03/en/activity-standard/iati-activities/iati-activity/policy-marker/narrative.rst>`_