Basic Navigation


Mode Selector
Current Entity
Property Groups
Entity Properties
Entity Navigator


Crate-O Main Menu
Crate-O Main Menu
Image Source: LDaCA

From the Main Menu, the following options are available:

File OptionDescription
Open DirectorySelect a directory/folder to locate or set where files are saved. This is the required first step for all RO-Crates.
Load FilesLoad files from the selected directory into this RO-Crate.
Bulk AddSelect an Excel spreadsheet or similar from a different directory to assist you with metadata description. This will append to your existing RO-Crate, if one has already been created. Note that this option currently only has functionality to add new data, and cannot overwrite or edit existing data in your RO-Crate.
SaveSave the state of this page into your RO-Crate. This will create an ro-crate-metadata.json file, or add data into an existing ro-crate-metadata.json file.
CloseClose without saving.
HelpDisplay general help from anywhere in Crate-O.

Mode Selector


Crate-O Mode Selector
Crate-O Mode Selector
Image Source: LDaCA

Below the main menu, the Mode Selector allows you to choose a predefined mode or load one from your computer.

Note that for blank RO-Crates, the mode will default to Simple RO-Crate Dataset, however for language data, the mode Language Data Commons top-level Collection (corpus) is most relevant.

When a file or folder is open in Crate-O, Selected Directory to the right of the Mode dropdown menu shows the directory or folder you currently have open.


Current Entity


Crate-O Current Entity
Crate-O Current Entity
Image Source: LDaCA

Below the Mode Selector, a home icon followed by entity breadcrumbs indicates your entity history, and underneath that, the entity you are currently located on. These will update as you navigate to different entities. Note that the breadcrumbs section doesn’t reflect the tree structure of the RO-Crate, but instead shows the history of the entities you have visited.

To the right of this is the option to Remove Entity that you are currently viewing (provided it is not the root entity).


Property Groups


On the left-hand panel, depending on the selected mode, different Property Groups will be available:


Crate-O Property Groups
Crate-O Property Groups
Image Source: LDaCA

Property GroupDescription
AboutThe core metadata for this RO-Crate and its subject matter.
Related People, Orgs & WorksThe context for the creation of this RO-Crate: who made it, funded it etc.
StructureHow the parts of this RO-Crate relate, such as collection and object relationships.
ProvenanceA detailed description of how entities were created, by whom and with which tools.
Space & TimeWhere and when the data was collected, i.e. the times and places it mentions or describes.
Software & HardwareComputer programs and execution environments that could be used to create data, have created data, or are being packaged and described.
OthersOther properties not in the above categories. Note that if you find a property in Other that should be in one of the above groups or have other suggestions, please raise an issue on GitHub.

Hovering over each property group will display tooltips related to that group.


Entity Properties


In the middle panel, the Entity Properties for the property group you have selected are shown.


Crate-O Entity Properties
Crate-O Entity Properties
Image Source: LDaCA

The exclamation mark icons to the left indicate that an entity is a required property for that mode, and saving an RO-Crate without completing one of these sections will result in a warning message. Below each field is a tooltip providing further detail on the given entity.

Each entity field has a ‘delete’ icon beside it, however these are only functional (and appear in red) for entities that can be removed, i.e. required properties cannot be deleted, but you can edit these.

There are several compulsory metadata fields required for each collection:

Property GroupMetadataDescriptionAdditional Notes
About@idPersistent, managed unique ID in URL format (if available), for example, a DOI for a collection or an ORCID, personal home page URL or email address for a person.Existing persistent identifiers for persons and organisations can be found at:
About@typeThe type of the entity.Both Dataset and RepositoryCollection are required for top-level collections in the Language Data Commons (LDAC) Mode, as these determine the available properties.
AboutNameThe name of this collection.
AboutDescriptionAn abstract of the collection. Include as much detail as possible about the motivation and use of the dataset, including things that we do not yet have properties for.May include but not limited to the following:
  • a brief description of participants (age range, gender, particular characteristics as a group, etc.)
  • purpose of the collection
  • research value of the dataset.
AboutLicenseLink to a document that describes the rights and obligations for users of this collection record.This does not necessarily cover the license terms that may apply to Objects in the collection which may have specific licensing. Licensing on specific objects overrides the license attached to a collection record.
Related People, Orgs & WorksAuthorThe person or organisation responsible for creating this collection of data.The options Person and Organization are available. If Organization is selected, the lookup pulls from the Research Organization Registry (ROR), or a new organisation can be created if not present.
Related People, Orgs & WorksPublisherThe organisation responsible for releasing this dataset.The lookup pulls from the Research Organization Registry (ROR), or a new organisation can be created if not present.
OthersRights HolderA person or organisation owning or managing rights over the resource.The options Text, Person and Organization are available. If Organization is selected, the lookup pulls from the Research Organization Registry (ROR), or a new organisation can be created if not present.
OthersAccountable PersonThe person or organisation who is the data steward for this resource.The options Person and Organization are available. If Organization is selected, the lookup pulls from the Research Organization Registry (ROR), or a new organisation can be created if not present.
OthersIn LanguageThe language(s) of the materials (including PrimaryMaterials, DerivedMaterials and Annotations) in this collection.The lookup pulls from AustLang, Glottolog and Ethnologue. Both AustLang names and codes can be used. If a language is not present, it can be created.
OthersSubject LanguageThe languages that the materials in the collection are about (not the language that it is in). This is particularly used on Annotations that may talk about PrimaryMaterials or DerivedMaterials.The lookup pulls from AustLang, Glottolog and Ethnologue. Both AustLang names and codes can be used. If a language is not present, it can be created.

To browse all the metadata entities associated with the LDAC Mode, see Metadata for Language Data.


Entity Navigator


On the Entity Navigator panel, there are some further options related to navigating and creating metadata entities.


Crate-O Entity Navigator
Crate-O Entity Navigator
Image Source: LDaCA

  • Create New Entity: Create a new metadata entity, such as a provenance action. For example, CreateAction describes how a work is created with more precision than a property like author.
  • All Entities: Select to view all metadata entities associated with your collection.
  • Unlinked Entities: Select to view all metadata entities that are currently not linked to any properties.

Below this, there is pagination which allows you to navigate through results, with 10 results appearing per page.