SciLifeLab Data Repository Submission Guidelines

1. Using the web browser, you can directly drag and drop files. To upload a folder, create a zip file of the folder and upload the zip file. This will preserve the file structure within the folder. Please note: most web browsers only can cope with single file uploads of up to 5 GB.
2. Using the FTP uploader. For more on uploading using the FTP uploader see here. 
3. Using the Figshare API. For documentation on using Figshare API, see here. For a quick start, see our GitHub repository with example scripts on interacting with the SciLifeLab Data Repository using API. Note that you should use the same base URL as for Figshare in general; based on the personal token that you generate in the SciLifeLab Data Repository, the item will be published in our repository. 

Readme and Manifest files

Please include both a README file and a manifest file with the item. These files can be created in plain text or in markdown format. Adding a README and a manifest file will improve accessibility for those downloading the item. The README file should preferably contain the same metadata as is filled out during submission, including the reserved DOI of the item. The manifest file should contain a list of every file included in the item and their approximate size in bytes. When uploading a file to the SciLifeLab Data Repository, a MD5 checksum for the file is automatically generated. Click on the Preview item link on the right-hand side options, which will display a new window, and click on the information icon to view the files checksum. 

Item without files

There are two options for items without files, metadata record and linked file item. These two options will only appear if you have not uploaded a file to the item. README and manifest files cannot be added to items without files as no files can be uploaded. However, in line with good data management practice, it is encouraged to keep a README and a manifest file locally or elsewhere together with the data.

Metadata record

If you cannot share the files openly, you may want to publish a metadata record. The metadata record differs from items with files in some aspects:

• The licence should always be “Restricted access”. 
• A access request email has to be filled out as described in section Access request email.

To create a metadata record, click the Set as metadata record box at the top of the screen and enter a reason for this choice.

Linked file item

This option is useful for files available elsewhere. Click the Link to external files box at the top of the screen and copy the link in the box to create a linked file item. 

Step 3. Add item information (metadata) 

When creating an item you will be asked to fill out metadata for the item. The metadata includes both mandatory and non-mandatory fields. The purpose of filling out the metadata thoroughly is to maximise the reusability of the item. Once an item is published on the SciLifeLab Data Repository, it should be self-explanatory. The SciLifeLab Data Repository should be used as a catch-all space, i.e. everything that is connected to the submitted item should also be submitted to or linked to here. 

Item title

This is a mandatory field where a title for the submitted item should be entered. The title should have an understandable scientific meaning, strive for an informative yet concise title. Make sure that the title is meaningful for someone without prior knowledge of the item. Avoid using underscores in the title as it can reduce the findability of an item. 

Group

This is a mandatory field where a group is chosen for the item. The purpose of this field is to connect the item with the correct research group, SciLifeLab platform or unit where applicable. If you do not have any group preferences, choose the repository main group “Science For Life Laboratory”. Each group receives its own URL. This URL can then be referenced from the research group, platform or units own web page. The submitter can contact the SciLifeLab Data Centre figshare@scilifelab.se in order to suggest the creation of a new group. 

Item type

This is a mandatory field where the submitter can select what kind of item is being submitted. 

The following item types can be uploaded to the SciLifeLab Data Repository:

• Book. Books are generally long-form documents, a specialist work of writing that contains multiple chapters or a detailed written study.

• Conference Contribution. Any type of content contributed to an academic conference, such as papers, presentations, lectures or proceedings.

• Data management plan. Data management plans are an integral part of a research venture, describing what data will be collected or created and how, and also the means by which it will be shared and preserved.

• Dataset. Datasets usually provide raw data for analysis. This raw data often comes in spreadsheet form, but can be any collection of data, on which analysis can be performed.

• Educational resource. Any type of content useful for teaching, learning or research in an educational context.

• Figure. Figures are generally photos, graphs and static images that would be represented in traditional pdf publications.

• Journal Contribution. Any type of content formally published in an academic journal, usually following a peer-review process.

• Media. Media is any form of research output that is recorded and played. This is most commonly video, but can be audio or 3D representations.

• Model. A formal representation of any system, entity, phenomenon or structure useful in the research endeavour.

• Online Resource. Any type of resource available online.

• Poster. Poster sessions are particularly prominent at academic conferences. Posters are usually one frame of a Powerpoint (or similar) presentation and are represented at full resolution to make it possible to zoom in.

• Preprint. Preprints are manuscripts made publicly available before they have been submitted for formal peer review and publication. They might contain new research findings or data. Preprints can be a draft or final version of an author’s research but must not have been accepted for publication at the time of submission.

• Presentation. Academic presentations can be uploaded in their original slide format. Presentations are usually represented as slide decks. Videos of presentations can be uploaded as media.

• Software. Code as a research output can either be uploaded directly from your computer or through the code management system GitHub. Versioning of code repositories is supported.

• Thesis. In order to distinguish essays and pre-prints from academic theses, we have a separate category. These are often much longer text-based documents than a paper.

• Workflow. Resource describing protocols, procedures, methods or activities part of a scientific experiment.

When uploading a presentation, poster or a preprint, make sure that you have permission to upload all that is included in the item, for example figures.

Authors

This is a mandatory field where the submitter can add the authors of the item. Every person that has been involved in the creation of the item should be added here; adding all of the authors makes the item more findable. If you are uploading on behalf of someone else, you can remove yourself as an author. 

It is recommended that you connect your ORCID to your account so it is visible on your author profile.  

Categories

This is a mandatory field where a discipline category is chosen for the item. The list of categories is fixed and based on the Australian and New Zealand Standard Research Classification (ANZSRC) Fields of Research (FOR) codes. Choose all categories that apply for the item. The list of categories is not specific for the field of life science which sometimes can make it difficult to find a correct category. However, remember that the keywords can be used to increase specificity in those cases. 

Keywords

This is a mandatory field where the submitter can add keywords to the item. The keywords can be more specific than the categories and should be used as a means to make the item more findable. Facilities submitting an item are encouraged to include the name of the facility as a keyword. There is no upper limit of the number of keywords, but remember to keep the keywords accurate and relevant. In order to increase interoperability of the item the keywords should be written in a formal, accessible, shared and broadly applicable language for knowledge representation. 

It is a free-text field and so special attention should be paid to the correct spelling of keywords. Misspelling keywords will decrease the findability of the item. Searches based on keywords are not case sensitive. 

Description

This is a mandatory, free-text field where a description of the item can be added. Ideally, the item should be self-contained and a user should be able to enter the item directly and find all of the information required to be able to understand and/or use the content e.g. reuse the data. For someone interested in the item it can be informative to know the purpose of the item, e.g. why was it generated/produced. In this field, information about specific software needed to open a file and the version of the software used by the submitters should be stated, along with a URL or DOI to this software.

For the item type dataset it should be clear how the data were obtained and what data each file contains. State who generated or collected the data and, if possible, specify the date this was done. Specify whether the data is raw or processed. In case of processed data, describe how it has been processed.

Funding

Related materials

This is a non-mandatory field where materials related to the item can be listed (e.g. DOI of the associated manuscript). For each related material added, the following information can be stated:

• Identifier (mandatory)
• Title (non-mandatory)
• Identifier type (mandatory)
• Relation type (mandatory)

For each related material you can also choose for it to show as a separate “call-out” box by ticking Show in linkout area. 

Licence

This is a mandatory field where a licence for the item is stated. A licence normally limits how the item can be reused and altered, in what context it can be used and how the creator should be credited. It is recommended that the licence selected be as open as possible. The appropriate licence can sometimes be specified by the funder, the publisher or institutional policies. 

Available licences: 

• CC0
• CC BY 4.0
• CC BY-SA 4.0
• CC BY-NC-SA 4.0
• CC BY-NC-ND 4.0
• MIT
• GPL 
• GPL 2.0 + 
• GPL 3.0 + 
• Apache 2.0
• Restricted Access

If you require another licence, please send a message to figshare@scilifelab.se. 

For metadata records, select the restricted access licence.

Publisher

This is a mandatory field where the submitter should state a publisher. The publisher can be, for instance, the university, the institute or the unit with which the submitter is affiliated. In general the publisher is the home organisation of the submitter.

Access request email (applies only for metadata records)

When uploading a metadata record, the submitter should fill out the access request email field to specify where file requests could be sent. If you are using the built in request access functionality, this field does not need to be filled out. 

For items other than metadata records, this field should be left empty. 

Contact email

This is a mandatory field that should be filled with the email address of the person to whom questions about the item should be directed.  

SciLifeLab acknowledgement

This is a non-mandatory field in which the submitter can acknowledge the involvement of a SciLifeLab platform, infrastructure unit, or central function (e.g. Data Centre, Training Hub). The submitter can select relevant option(s) from the drop-down menu. Please contact SciLifeLab Data Centre in order to request additions to the options in the list.

The purpose of this field is to give credit to platforms, units, and/or functions that were involved in the work. It is not intended as a general acknowledgements section, as one might exact in a traditional publication. Any individuals involved in the work should instead be given credit by being listed in the “Authors” field. 

Step 4. Item actions 

Add embargo and restricted access

To use this functionality, click on Add embargo and restricted access. You can select a time period for the embargo or, select permanent embargo, where restrictions to the underlying files will apply. It is not necessary to apply the embargo to the entire item. Indeed, you can choose whether the embargo applies only to the files or to the entire content (files and metadata). You can then choose who can access the embargoed content (i.e. before the embargo period expires). By choosing Nobody, you ensure that nobody will have access to the embargoed content until the embargo period expires. Choosing Custom instead enables you to select, for example, whether access should be restricted to all users of the SciLifeLab Data Repository when they are logged in.

The item owner can also change the title of the embargo to describe the type of embargo applied (the standard text is “File(s) under embargo”) and can optionally add a reason as to why this item is under an embargo. 

It is also possible to allow users to request access to embargoed files. Note though that this functionality is not available for metadata records. To enable the functionality, tick the Allow anybody to request access to the embargoed files box. You can include additional information as a message for anyone requesting access to the files.  When this functionality is enabled, a button with the text “Request access to files” will appear on the published item. Anyone looking to request access needs to be a user of a Figshare instance. When users click on this button, they will see the added message (data access statement) and can choose to send an access request. If a user requests access to the restricted files through this feature, you and the institutional administrators will receive an email request to grant access. There is currently no way to share restricted access files with a user in the interface, this has to be done using an external service.

Share with private link

Click on Share with private link to create a link that you can share. If desired, this link can be disconnected in the future. To find the private link for an item in a project, click on the item and then click on Share. However, this is only possible after the item owner has generated the private link. 

The private link should not be used to cite the item in publications. 

Manage Identifiers

Click on Manage persistent identifiers to manage the persistent identifier (PID) for the item. Here you get the possibility to reserve a Digital Object Identifier (DOI). This DOI becomes active when the item is published and can be used to cite the item in publications.  

Add custom thumbnail

Click on Add custom thumbnail to select a custom image for the item’s thumbnail preview shown on the public side.

Step 5. Publish items

Step 6. Modify items

Edit items

You can go back and edit items after you have made them publicly available. To edit an item, click on the pencil that appears to the right of the item when hovering over it in My data. You can also batch edit items that have already been published: in My data, select the items to be updated, click on Actions at the top of the page, and select Edit in batch. Once you have selected the items to be edited in bulk, select the metadata fields to edit.

When editing a published item the item will be sent for a new review. When editing an embargoed record, amending or removing the embargo will also send the item back for review. To expedite this review, please send a message to figshare@scilifelab.se and explain which changes that were made to the item. When adding, removing or replacing files, remember to also update the manifest file to reflect the new state of the item. 
 
Some changes may trigger a new version of the item. See here to find out which amendments will generate a new version. When a new version is generated, the previous versions will still be available. Each version will have its own DOI, where the version number is added as a suffix to the base DOI. See this item as an example. The base DOI will always point to the latest public version on the item.

Delete items

To delete unpublished items, click on the Delete item button in the metadata form to delete a private item. 

Published items are considered to be published permanently and can only be deleted in special cases. If you wish to delete a published item please contact Data Centre at figshare@scilifelab.se.

For further questions, please contact figshare@scilifelab.se