A Resource Template is a set of pre-defined Properties, optionally with a Class, to guide Item creation and the interpretation of Properties.

Resource templates are managed from the Admin Dashboard, accessed through the left-hand navigation under the tab labeled Resource Templates.

Basic view of resource templates tab, showing the column titles and one template

From this tab, you can sort existing templates by label, class, or number of items assigned to that template, using the up-down arrow icon next to each column heading. You can also use the icons in each template’s row to: edit (pencil), delete (trash can), or view details (ellipses). If you click on the number of items listed for a template, it will take you to a list of all those items.

Base Resource

All Omeka S installations include a Base Resource template which maps to the metadata fields required by the Digital Public Library of America (DPLA). It will display in the table of resource templates as "Base Resource" with no owner.

Base resource template displayed in the table of templates

The Base Resource template contains the following Dublin Core fields: Title; Rights; Type; Creator; Date; Description; Format; Language; Spatial Coverage (Place); Publisher; Alternative Title: Contributor; Extent; Identifier; Relation; Is Replaced By; Replaces; RightsHolder; Subject; Temporal Coverage.

Create a resource template

From the Resource Templates tab in the Admin Dashboard, click the Add new resource template button.

The New resource template page will load with options for Label, suggested class, and the properties Title (dcterms:title) and Description (dcterms:description)

The Add Resource Template page, with fields for title, class, and properties Title and Description pre-loaded

  1. In the Label property, type the label for your new template. This will be the text displayed in the dropdown for Resource Templates when creating an item, so be sure that the label is clear.
  2. If desired, select a class to associate with the template.
  3. Add properties from the list of vocabularies in the menu on the right side of the screen. You can filter properties in the text box or select from a specific vocabulary using the arrows to the right of the vocabulary names.
  4. If desired, modify the property (see Property options, below)

Be sure to Save your resource template before leaving this page.

Property options

You can modify the display label, comment on the label, set a property as required, and set the default data type for each property in your template.

To do this, click the edit (pencil) icon in the row for the property you wish to modify. This will open a drawer on the right side of the screen with the ability to edit the properties:

Label
Change the displayed label of the property that appears when the template is applied to an item by entering the text you want to appear in the Alternate Label field for each property.

Comment
Add alternate comments for the property in the field Alternate in this section.. This will change the text under the property name when users are creating items using your Resource Template.

Other options Use the checkbox to determine whether a property is required when the template is in use.

Using the dropdown, you can designate a data type for the property: Literal, URI, or Resource. Whichever you choose will be automatically loaded once someone selects that Resource Type and they will only be able to use this data type for the element when using this Resource Template.

  • Literal: text and/or html imput
  • URI: a link with label
  • Resource: either an existing Item or Item Set in the Omeka S install.

In the image below, from an Add Item view, the template has been written so that the Description property is labeled as Gist with an new comment (the default is “an account of the resource”):

A property labeled Gist with the comment “Brief Summary”

Note that users who select this resource template when creating an item will still be able to add other properties to the item, and that they will only be required to fill out those which you check as required.

Note you must click the Set Changes at the bottom of the drawer for each property that you edit before exiting the drawer or moving on to another property! If you do not click Set Changes, your edits will not be saved.

A close up of the drawer for editing property options with a large red arrow pointing down at an angle to the Set Changes button, which is on the very bottom of the image.

Sharing Resource Template

It is possible to share a resource template between Omeka S installations by exporting and importing them.

Export Resource Template

To export a resource template from your Omeka S installation:

  1. Go to the Resource Templates menu on the main navigation.
  2. Click the Label of the template you want to export.
  3. On the resource template view page, click the Export button in the upper right corner of the screen.

A red arrow points to the export button on a screen showing a resource template labelled "Textual Work"[^]

Exporting a Resource Template will download it to your computer's default download location as a json file with the same name as the Resource Template's Label.

Import Resource Template

To import a resource template (exported from a different S installation) into your Omeka S installation:

  • Go to the Resource Templates menu on the main navigation
  • Click the Import button in the upper right corner of the screen.

Red arrow points to the Import button on the browse resource templates page of the admin site of an Omeka S installation

  • On the Resource Template: Import page, click the Choose File button
    • This will open your browsers file selection window. Choose the json file for the resource template you want to import
  • Click the Review import button
    • On the Review page, you will be able to check that Date Types, Alternate Labels, and Alternate Comments have been imported correctly
    • Imported templates which used Value Suggest or Custom Vocab will indicate in the Data Type column what the original source was, and a dropdown to allow you to select a new Data Type (if you do not have the necessary modules, the dropdown will only show the default options).

On the review imported template page, all the elements for the reviewed import are highlighted green. The final element, subject, lists a datatype of Value Suggest and has a dropdown for users to select a new data type.

NB: If you want to import a Resource Template using a Custom Vocab, you will need to manually reproduce the Custom Vocab on the second Omeka S installation before importing the resource template.