Skip to main content

Create an individual item

Adding items to the SSH Open Marketplace is an easy process. Here are the 5 steps you can follow to create an item on your own.


1. Log in

First, you need to sign in to the SSH Open Marketplace which should be possible very conveniently using already existing credentials (academic or social accounts are available). 

Sign in the SSH Open Marketplace steps 1 and 2

Sign in the SSH Open Marketplace step 3


2. Reflect on our inclusion criteria

Take a moment to reflect on our [4 inclusion criteria questions](/about/data-population#inclusion-criteria-for-adding-resources-4-questions-to-ask):

  • Is this resource relevant to the SSH scientific community?
  • Is the resource current, supported, and ideally open?
  • Is the resource FAIR – Findable, Accessible, Interoperable and Re-usable - or contributing to the uptake of Open Science best practices?

If you answer yes to these first three questions, you are (almost) good to go! The last question you should consider is the following:

  • Is the resource already in the Marketplace? Take a look at existing items, typing the name of your resource in the search. If the same item already exists, please consult the next section Edit/Enrich an item. If you get no results, then you may proceed with the creation of your item!

3. Choose the item type

The first choice you need to make to create an item in the SSH Open Marketplace relates to the type of content you want to add. At the moment, 5 different content types are available:

Tool or service

Tools & services

Training Material

Training materials







If you are unsure about which item types you should choose, you can take a look at our dedicated section.

Once you know which type to choose, click on the appropriate creation button:

"Create an item" banner


4. Fill in the form

Once you click on the “Create” button for your chosen Marketplace entry, the various fields that can be filled out will be automatically proposed. 

Note: if you are creating a DARIAH national resource, you can also take a look at our dedicated guidelines.  

Edit form "Create a training material" screenshot

The full metadata guidelines are available here. However, below are some examples of the main questions you may encounter when creating your resource.

  • Which fields should I fill in?

    Only two fields are mandatory in the SSH Open Marketplace: label (= name of a resource) and description. However, we strongly encourage you to fill in all the recommended fields that are present by default in the forms, depending on the item types you want to create (i.e. if you want to create a publication, all the bibliographic metadata are included by default in the edit forms). See metadata status section for details.

  • How to create a good description of a resource? Check the original resource, and if possible, reuse the text description of the source. This description should be short and should aim at raising interest Example: “Gephi is a Photoshop alternative for the humanities….”! We recommend a short paragraph, around 800 characters, although longer descriptions may be needed for a workflow and its steps.

    Description field supports Markdown, although to include links we recommend using the See also property.

  • What is the external ID field and how to fill it?

    In addition to the link/URL of a resource (accessibleAt field), external identifiers should be added when possible. They link Marketplace items to other authoritative representations of any given resource on the web, such as a git repository or a wikidata or wikipedia entry and contribute to increase the (meta)data quality. 

    Note: these external identifiers are available both for Marketplace items (Wikidata, Github, DOI or Handle.Net identifiers) as well as for Actors (ORCID, Wikidata, Twitter or ROR identifiers).

    As shown below, to add an external ID to an item, you first need to click on “Add External ID”, then to choose which type of IDs you want to add, and finally to add only the last part of the related URL (ex. only add DARIAH-ERIC/dariah-campus in the field if you want to refer to Below the field you can preview the generated URL.

Add an external ID - step 1

Add an external ID - steps 2 and 3

  • How to add or create actors?

A few recommendations are given in the metadata guidelines (scroll down until “actors”). An Actor is a person or an organisation who contributed in some way to the creation of the resource described in the SSH Open Marketplace. Here is a more detailed description of the steps to follow to add or create an actor.

  1. While on an item form, you want to add an actor, but can not find it in the existing list of actors. The search bar will give you a “no results found” like in the screenshot below.  

  1. You can create an actor using the “create actor” button on the right

Create an actor button

  1. Name of an actor is mandatory: while creating an actor, you need at least to add a name.  Add ExternalID for actors: ORCID, recommended. Add ROR IDs for research organisation. Affiliations can also be added, but the choice is possible only among the current list of actors. So if you don’t find an affiliation, you need to create it as an actor as well.

Add actor external ID screenshot

Note on the actors’ roles. For a given item, you can choose a role for an actor: contributor, author, reviewer, director, programmer, editor, provider, contact, funder, helpdesk. By default, the Actor’s role is contributor. 

  • Which Activity to choose to describe an item?

    The “Activity” field is an important one! It allows a description of the activity you can do with the resource. You can select a term, drawn from the Taxonomy of Digital Research Activities in the Humanities (TaDIRAH) that is “designed to help community-driven sites and projects structure their digital humanities (DH) content and gain better visibility”.

    To choose among the TaDIRAH concepts, you can either start typing a term you have in mind to see if it exists, or consult existing terms, via the TaDIRAH browser: .

    TaDIRAH has 7 top concepts, grouping a bit more than 150 concepts in total. Here is a list of this top concepts, to give you an idea of what is covered by this taxonomy:

    1. Analyzing
    2. Capturing
    3. Creating
    4. Disseminating
    5. Enriching
    6. Interpreting
    7. Storing

    Please note that if you want to add several activities, you will need to add (a) new property line(s) in the edit form, via the “add property” button.

  • Which license to choose?

Licensing information is very important (especially for the tools & services). Knowing at a glance under which conditions and with which licence a service is available can greatly facilitate its re-use. You can select a license, drawn from the controlled vocabulary SPDX License List. If you do not find any match in this vocabulary, please leave the license field empty and fill in the terms of use

The terms of use field is a free text field, so you can add anything you want in it. 

  • How to add an image?

Two different kinds of images can be added to a resource: media that appear in the middle of an item page and thumbnail (=logo) that are displayed on the top left corner of an item, just before the name of a resource.

Positions of the two different images in the item detail view of an item


Media can be images or videos. Clicking on “+ Add Media” will open a pop-up window, like shown in the screenshot below.  

Screenshot of the media pop-up window

Some recommendations to add images: 

  1. Look for freely available screenshots or visualisations of a tool (CC licence or similar). 
  2. If that doesn’t yield good results, look for material available on the original website. 
  3. Consider making own screenshots. 
  4. NOTE: You can add the URL of an image, if you choose to upload, image must be 1MB or smaller in size. Format supported: JPG, TIFF, PNG, GIF. 

Some recommendations to add videos: 

  1. If on YouTube or Vimeo: just deliver the URL provided in the embed sharing settings of the platform as shown in the Youtube screenshot below. 
  2. If elsewhere: provide link to video and descriptive caption. 

link to add to the MP highlighted in blue

Media-caption: every media should include a descriptive caption, i.e verbose information mentioning license and credits about the media used.


To visually enhance the resource entry, a thumbnail can be inserted. It will appear on the top left corner, just before the name of an item. 

Please try to provide a logo related to the MP Entry, if we are authorized to use it. If no logo is submitted, a generic icon is automatically provided. Recommendations in terms of quality: 200x200 pixel.

  • Why and how to add relations to an item? 

If other entries and items in the MP are related to your tool or service (e.g. training material or publications) it is very relevant information for the user to indicate this connection here. Not only does this increase the likelihood of people browsing the Marketplace serendipitously discovering connections, but it also creates context around a resource and thus makes it easier for newcomers to understand how this resource can be used. Please note that in the near future, datasets and publications without any relations will be deleted from the Marketplace. It is particularly important to add relations to other items when you create datasets or publications items. 

You have several options of  how to specify the relation:

  • Simple relation (relates to / is related to) - this is the type of relation attributed by default
  • Documentation (documents / is documented by) - if the resource created can be described as documenting another one, this relation type should be chosen. Ex: a training material documents the use of a tool. A tool is documented by a training material.
  • Mention (mentions / is mentioned in) - if the resource created is cited in another resource, this relation type can be chosen. Ex: a tool is mentioned in a publication. A publication mentions a tool.
  • Extension (extends / is extended by) - if the resource created is a direct extension of another, either because it develops it further or maybe because it adds to or prolongs another, this relation type can be chosen. Ex: a training material extends another from the same curricula, a service is extended by a new component (itself registered as service in the MP).  

Only registered entries of the MP can be chosen as related item: if you start typing the name of the item it will be suggested automatically in a list.

2 steps describing how to add related items

If you need some explanation or examples for some of the metadata fields, please consult the “Guidance for metadata fields” table.

Once you fill in everything you wanted, you are ready to submit it to the moderators. You can also save your proposed item and come back to it later, if you realise that you need some more time to work on perfecting the entry before submission to the editorial team. Via the “My account” dashboard, you can access your contributed and draft items.

"My contributor account" screenshot


5. Suggest the item for moderation

What happens next? 

Once you click on the  “submit” button, your suggested item is reviewed by a moderator (i.e a member of the Editorial Board) who will accept or reject it. In case of rejection or additional questions, the moderator will get in touch with you.

Once accepted, your item is published on the SSH Open Marketplace. You and other contributors can still edit the entry (see next section).

European Union flag

The SSH Open Marketplace is maintained and will be further developed by three European Research Infrastructures - DARIAH, CLARIN and CESSDA - and their national partners. It was developed as part of the "Social Sciences and Humanities Open Cloud" SSHOC project, European Union's Horizon 2020 project call H2020-INFRAEOSC-04-2018, grant agreement #823782.