.. include:: globals.txt

#########################
Using the Metadata Editor
#########################

********************
Launching the Editor
********************

|launching_metadata_editor_gif|

If a record has already been created for you, you will see the metadata icon |metadata_icon| to the right of your folder's name. If this is the case, click the metadata icon to launch the editor.

.. note:: You can also create metadata records for individual data files, but this is less common than using one folder-level record to describe the entire dataset.

If you don't see the metadata icon, highlight the folder that contains (or will contain) your data files and left-click on the blue metadata editor icon |meditor_icon| near the top of the window. This will launch the editor with a blank record.

.. tip::
	To launch the metadata editor, you can also right-click on a folder name and select ``Metadata`` from the drop-down menu.

*****************************
Adding Content to Your Record
*****************************

|adding_content_metadata_editor_gif|

To create new content in a metadata record, enter it using the white text boxes associated with each field. If you have prepared your metadata in another program (e.g., a text or XML file), you can copy-paste the content for each field into the text boxes.

There are several useful shortcuts for getting content into a metadata record:

#. :ref:`copying-from-other-records`
#. :ref:`saving-a-record`
#. :ref:`adding-contacts`
#. :ref:`version-control`
#. :ref:`adding-data-table-attributes`

******************
Exiting the Editor
******************

|exiting_metadata_editor_gif|

To exit the metadata editor and return to you project view, click the green button with the white arrow |back_button_icon| in the upper left corner of the window.

********************
Additional Resources
********************

Writing ISO-compliant metadata can feel overwhelming, but it's important to remember that you **don't have to fill out every field of a record** in order to describe your dataset.

For a list of which fields to focus on, please refer to the our `Metadata Cheat Sheet <http://www.axiomdatascience.com/best-practices/MetadataCheatSheet.html>`_.

.. tip::
	Metadata fields that typically need the most attention from researchers are the Abstract and Purpose fields, as well as the Methods section (Resource Lineage, Process Steps, and Data Quality Reports).

For more help authoring high-quality metadata content, please see Axiom’s `Best Practices for Scientific Metadata <http://www.axiomdatascience.com/best-practices/MetadataBestPractices.html>`_.

For more details on working with the metadata editor, please see the :ref:`metadata-editor` page.