Contribute data

If you would like to contribute data to be included in OpenTexts.World, please email stuart.lewis@nls.uk and gill.hamilton@nls.uk for details.

Formats accepted

We can work with MARC21, Dublin Core or CSV (comma-separated) files in the format below. We have also been able to harvest data via OAI-PMH and IIIF discovery, or via custom existing data feeds and APIs.

If your data is in another format, please contact us as we may be able to process and integrate it. We love a challenge!

Comma-separated format

If you are submitting comma separated data please follow the format below. Contact us if you want to include other data/fields that are not represented in the format - we'll try and adapt our tools to accommodate your data.

Repeatable fields must be separated with a '|' pipe.

Heading Content Requirement Repeatable
organisation Unique name of provider Mandatory Not repeatable
So we know which organisation contributed the metadata and content. This info will be displayed in a facet and in the full record display. E.g.: Wellcome Library, National Library of Scotland, HathiTrust.
idLocal Local identifier Mandatory Not repeatable
ID from the local system - so each library can look up their local system if there's a query.
title Title of the work Mandatory Not repeatable
For example MARC 245 $a $b or DC terms:title.
urlMain URL to access the item Mandatory Not repeatable
The URL that is most appropriate for a user to follow to get direct/immediate access to the content. May be in MARC 856 or DC terms:identifier. This will likely be a 'landing page' containing metadata about the item and the item itself.
year Year of publication Desirable Not repeatable
This needs to be numeric and four digits in length as it is used to feed the year filter.
date Date of publication Desirable Not repeatable
Ideally numeric but can be any value. MARC 008 position 7-10 rather than MARC 260 $c - e.g. preferred to 1884 vs ca.1884). May be in DC terms:date.
publisher Publisher Desirable Repeatable
May be in MARC 260 $b, MARC 264 $a, or DC terms:publisher.
creator Creator Desirable Repeatable
Author, editor, creator, organisation - any named person or organisation involved in the creation of the work. May be in MARC 1xx, 7xx and DC terms:creator, DC terms:contributor.
topic Subject or topic Desirable Repeatable
May be in MARC 6xx, and DC terms:subject.
description Description Desirable Repeatable
Description about the content. May be in MARC 5xx or DC terms:description.
urlPDF URL of a PDF Optional Not repeatable
urlIIIF URL to a IIIF manifest Optional Not repeatable
urlPlainText URL to a plain text file Optional Not repeatable
urlALTOXML URL to an ALTO XML file Optional Not repeatable
urlOther Other URL(s) Optional Repeatable
If there are other URLs for the content that may be useful - perhaps Google Books URL, or link to the catalogue record of the original.
placeOfPublication Place of publication Optional Repeatable
May be in MARC 260 $a or MARC 264 $a or DC terms:coverage.
licence Licence of the material Optional Not repeatable
May be in MARC 540 or DC terms:rights. For example CC-BY.
idOther Other IDs Optional Repeatable
Other local or external identifiers such as DOIs.
catLink Direct record link Optional Not repeatable
A link to the item in your catalogue or discovery system.
language Item language Optional Not repeatable
May be in MARC 008 position 35-37 and/or MARC 041.[code list] or DC terms:language. Additional default values of 'Not specified' and 'Undetermined'.