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.

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). 

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!

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:

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:

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.  

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 https://github.com/DARIAH-ERIC/dariah-campus). Below the field you can preview the generated URL.

• 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.  

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

3. 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.

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: https://tadirah.info/pages/Browser.html .

  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.

Media 

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

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. 

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

Thumbnails

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.

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.

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).