Items are the building blocks of the Omeka system.

In Omeka S, items can be made available to you from the system administrator, and you may add items to your own site.

Items are listed in the Items tab (one box icon), found on the left-hand navigation of the administrative dashboard.

Basic view of admin items page, showing a handful of item resources

Each item appears as a row, with columns for:

  • the Title
  • icons to edit (pencil), delete (trash can), or view details (ellipses)
  • the Class
  • the item’s Owner
  • and the date the item was Created.

Options for navigating and creating items display above the table of items.

On the left side is a display for the number of pages of items, with forward and back arrows. The current page number is an editable field - enter any valid page number and hit return/enter on your keyboard to go to that page.

In the center top is a button for Advanced Search.

On the right top of the Items window, above the table of items, is the Add new item button. Just above the table on the right are options for sorting the table of items, with two dropdown menus. The first lets you select between Title, Class, Owner, and Date Created; the second allows you to sort ascending or descending. To apply, click the sort button.

View

To quickly view the basic information about an item, click the view details (ellipses) button in the row for the item, located next to the edit and delete buttons. This will open a drawer to the right of the list which displays the item’s title, description, and visibility.

For a more detailed look at an individual item, click on its title in the items browse table or when viewing its details.

When you view an individual item , there are tabs for the item’s Metadata and its Linked Resources. The right side of the page displays the item’s media, any item sets to which it belongs, its creation date, owner, and visibility.

Item browse view with details open for Case of Identity. Links to item view page squared in blue The blue squares indicate where to click to open the full item view.

An item’s linked resources (shown below) are resources, which have been added as properties to the item. Note that this section only shows resources which have been linked to this item (which have it for a property); resources which are linked from this item will display in the property which they fill.

Linked items are grouped by the property for which they use the current item. In the example below, the item William Shakespeare is used for the properties "Creator," "References," and "list of authors" for the linked resources.

You can filter linked resources to only display those referencing a specific property using the dropdown "Filter by property." It will only display properties actively in use.

Item linked resources view for William Shakespeare, with six plays using Shakespeare as Creator, the item Folger Shakespeare Library listed as 'references' Shakespeare, and the Globe Theatre using Shakespeare for 'list of authors'. Each property cluster is in a separate rectangle, headed by the property being referenced.

Adding an Item

To add a new item, begin by selecting the the Add new item button.

Before creating items, site admins may want to create Resource Templates, which will load specific fields for various item types.

Values

The Values tab is where you enter metadata, such as title, description, etc.

Basic view of add items page, with no content entered

You can select a resource template from the drop-down menu. Resource templates are defined by the site administrators and editors.

  • If using a resource template, the class should automatically load.
  • If not using a resource template, you may select a class from the dropdown menu (these are populated from the Vocabularies in your installation).

Add information to the properties which load. If you do not select a resource template or class, the Dublin Core properties Title and Description will load automatically.

You may add text, a resource from the installation, or an external link in each field.

Text

Text fields allow for unformatted text entry.

image of text input field with keyboard icon indicating text input, the globe icon for setting language, and a trashcan delete icon

You can indicate the language for the content of an input using the globe symbol above the input (see the red arrow in the image below). Click on the globe to activate a text field, then enter the ISO 639-1 code for the language in which the text is written.

Red arrow points to the globe icon and a text entry field highlighted in blue

Omeka Resource

Omeka Resource fields create an internal link between the resource you are creating and the resource which fills that field.

When creating an item, you have the option to use either another item or an item set. Once you select an item or item set, detailed information will load, and you must click select resource to finish linking the resources. You can also click the X button in the upper right-hand corner to go back to the list of items or item sets.

Select Item menu with list of items to link in edit item view

Once you have created an item and added media to it, you will also have the option to use media attached to that item for a property.

A blue outline of a rectangle highlights resource options for Items, Item sets, and Media to be used as the input for the element "Description"

To use a media resource for a property, select the media option for the element (1). The drawer which opens will display all media attached to the item. Select the media which you want to use(2); this will switch the drawer to just that media (second image). Click the Select Resource button at the bottom of the drawer to complete the process (3).

Focus on the editing portion of a window for the item "Sense and Sensibility", with the elements Title and Description visible. On the right side of the window, a vertical rectangle (the drawer) is open on the right displaying five media which are attached to the item, including video, images, and text. This image contains steps 1 and 2.

The same window as before, but now the drawer on the right displays a thumbnail of the media "Sense and Sensibility DVD Trailer" with a dark gray button labeled "select resource" at the bottom of the drawer area. This image contains step 3

URI

URI fields link to an external website or online resource.

You may add other fields by selecting a property from the list on the right. Browse fields by vocabulary (Dublin Core, Bibliographic Ontology, etc), or search in the filter properties bar above the list of properties and vocabularies.

Language

You can indicate the language for the content of an input using the globe symbol above the input (see the red arrow in the image below). Click on the globe to activate a text field, then enter the ISO 639-1 code for the language in which the text is written.

Red arrow points to the globe icon and a text entry field highlighted in blue

Media

Use the Media tab to add images, video, or other files. Using the buttons on the Add New Media menu on the right side of the screen, select a media type (Upload, URL, oEmbed, YouTube, or HTML)

“Add new media” drawer showing the options

  • Upload: select a file to upload from your computer.
  • URL: import media via a uri.
  • HTML: add html content as a media resource for your item.
  • IIIF: Add an IIIF image via url.
  • oEmbed: insert an embedded representation of an external URL. Note that this will only work with content from existing oEmbed implementations - use the url in your browser’s location bar.
  • YouTube: add a link to embed a YouTube video. Use the url from your browser’s location bar (with /watch/ in it) rather than the youtu.be link.

If you have more than one media instance for an item, you can reorder them by dragging and drop each media instance block, using the icon of three lines in the upper left corner of the block as the anchor when dragging (click there).

You can edit media later by going by editing an item, navigating to the media tab, and clicking the edit button (pencil) for a media when editing the item.

You can delete any media instance from the item's edit page using the delete button (trashcan) on the upper right corner of the media block.

Image shows a close up of a media item being removed - it is red and has an undo curling arrow at the right end of the block

Item Sets

You can only add items to existing item sets.

From the right-hand menu, click on the owner of an item set, then click the name of the item set to add the item to that set.

You can also filter item sets using the text entry bar above the list of users.

To remove a connection between an item and item set, click the delete (trash can) button to the right of the item set title.

item set tab with one item set added

Visibility

Use the make public/private button (eye icon) to set whether the item is visible to the public or only to users of the Omeka S system.

make public button showing an eye icon Public

make private button showing an eye icon with a diagonal slash through it Private

Note that if an item is private, all the media attached is private, but an item which is public can have attached media which are set to be either public or private.

Batch editing

From the browse page of items (admin/item) you can batch edit items, using the dropdown menu on the upper right near the "Add New Item" button. You can select multiple items using the checkboxes on the left of each item's row.

A red arrow points to the dropdown for batch editing and deleting options

Batch actions are as follows:

  • Edit selected: edit only the items that are selected on the page
  • Edit all: edit all the items returned by a search (default is all items)
  • Delete selected: delete only the items that are selected on the page
  • Delete all: delete all the items returned by a search (default is all items)

Choose one of these options and then click Go.

Batch editing items takes you to a new page. The items being edited will display on the right side in a drawer, while the batch edit form gives you the following options:

  • set visibility: a dropdown, select from public or not public.
  • set template: a dropdown, select from the installation's resource templates.
  • set class: a dropdown, select from classes of the installed vocabularies.
  • add to item set: a dropdown, select from item sets on the installation. Add to an additional item set using the add another item set button.
  • remove from item set: a dropdown, select from item sets on the installation. Remove from an additional item set using the remove another item set button.
  • clear property values: a dropdown menu with all the properties in all vocabularies, selecting from this will remove any values in that property in the affected items. Clear additional properties using the Clear another property button.

Batch edit items form, with options as described above. Everything is grayscale

In addition, you can use the bottoms at the bottom of the batch edit form to add properties to every item:

  • add text value
  • add resource value
  • add URI value

Selecting any of these will add a block to the form where you can select a property from the installed vocabularies and enter the value for that property.

Image depicts only the Add text value block of the batch edit form, with a dropdown labeled "select property" above an empty text field

For the delete actions, a drawer will open on the right side of the screen telling you the number of items which will be deleted. Nothing will be deleted unless you click the red Confirm Delete button. This action cannot be undone. To opt out of deleting the items, click the X in the upper right corner of the deletion drawer. To confirm delete, check the "Are you sure" checkbox and then click Confirm Delete

Close up of the warning, with the text describing the number of items to be deleted in red.