Creating a New @xml:id

When creating a new file or entity, encoders need to conform to MoEML’s naming conventions. Files are either XML documents or binary documents. Files in MoEML need unique IDs that are of the words_with_underscore type (see below for details). Entities are referents to items of various types (locations, people, etc.), generated in files including but not limited to: PERS1, ORGS1, GLOSS1, and BIBL1. Entities can also have files of their own, in corresponding project folders, such as The Triumphs of the Golden Fleece (GOLD4) file in the a_lord_mayor folder. These entities require unique IDs that are of the XXXX1 type (see below for details). Note that files that refer to entities will have a combination of both ID types: words_with_underscore_XXXX1 (see Stow example below). The project’s schema will prevent you from adding names which do not conform.

Checking and Validating your @xml:id

The first thing you need to do when creating an ID is to check MoEML’s A-Z Index and make sure that you are not duplicating an entity ID. An easy way to do this is to try and find the ID you are about to create: ctrl+F (for Windows) or command+F (for iOS) then type in your new ID. If you cannot find it, the ID does not already exist and can be added. If it already exists, use the next numeral available. For example, if you are about to add TEST1 and you find it in the index, change the ID you are creating to TEST2.
The A-Z index can take a long time to load. For a simple list of all xml:ids, see the .txt version of the A-Z Index. This page can be found by simply changing .htm in the A-Z Index’s URL to .txt.

Creating a New Entity ID

An entity can refer to a location, person, work of literature, and others. For example, the historical person George Abbot has an entity ID of ABBO1.
When creating a new entity ID, you must follow MoEML’s entity ID structure, which consists of 4 capital letters, followed by the next available integer (i.e., a sequence of one or more digits).

Creating a New File ID

In MoEML, you can either create born digital files or encoded primary sources:
  • When naming born digital files in how_to and info, use lower-case letters and underscores to separate between words (e.g., draw_on_agas, encode_library_text).
  • When naming primary source texts that are housed in library, use four letters and a number (e.g., MAGN3, CHRU1).
  • When naming parts of Survey of London that are housed in stow, use stow, followed by an underscore, followed by the edition year (four digits), followed by an underscore, followed by either a word (in lower-case letters) or entity ID (if one already exists). For example, stow_1598_bridges is the file name of Bridges in London and stow_1598_ALDE2 is the file name of Aldersgate Ward (ALDE2 is the entity ID of the ward).

Creating Binary Documents

Binary documents are non XML files/documents; this includes PDFs, Word documents, images, and videos. When naming such documents/files, follow the naming conventions for files in how_to and info: use all lower-case letters, and only underscores to separate between words.
If you are not sure if a file name or entity ID fits MoEML’s naming conventions, or if you have any questions, please consult with the MoEML team.

Cite this page

MLA citation

El Hajj, Tracey. Creating a New @xml:id. The Map of Early Modern London, Edition 7.0, edited by Janelle Jenstad, U of Victoria, 05 May 2022,

Chicago citation

El Hajj, Tracey. Creating a New @xml:id. The Map of Early Modern London, Edition 7.0. Ed. Janelle Jenstad. Victoria: University of Victoria. Accessed May 05, 2022.

APA citation

El Hajj, T. 2022. Creating a New @xml:id. In J. Jenstad (Ed), The Map of Early Modern London (Edition 7.0). Victoria: University of Victoria. Retrieved from

RIS file (for RefMan, RefWorks, EndNote etc.)

Provider: University of Victoria
Database: The Map of Early Modern London
Content: text/plain; charset="utf-8"

A1  - El Hajj, Tracey
ED  - Jenstad, Janelle
T1  - Creating a New xml:id
T2  - The Map of Early Modern London
ET  - 7.0
PY  - 2022
DA  - 2022/05/05
CY  - Victoria
PB  - University of Victoria
LA  - English
UR  -
UR  -
ER  - 

TEI citation

<bibl type="mla"><author><name ref="#ELHA1"><surname>El Hajj</surname>, <forename>Tracey</forename></name></author>. <title level="a">Creating a New <att>xml:id</att></title>. <title level="m">The Map of Early Modern London</title>, Edition <edition>7.0</edition>, edited by <editor><name ref="#JENS1"><forename>Janelle</forename> <surname>Jenstad</surname></name></editor>, <publisher>U of Victoria</publisher>, <date when="2022-05-05">05 May 2022</date>, <ref target=""></ref>.</bibl>