Support Home Analysis Publishing and Open Science How To: Gorilla Open Materials

How To: Share your tasks on Gorilla Open Materials

  • Introducing Open Materials
  • Create an Open Materials Page
  • Edit a Page
  • Add a Material
  • Preview a Page
  • Publish a Page
  • Open Materials Repository
  • Corresponding Author Info

Introducing Open Materials

Gorilla Open Materials is our contribution to Open Science on the Gorilla platform. In a nutshell, Open Materials is an open-access repository within Gorilla where you can publish your experiments, tasks and questionnaires. This will enable researchers across the world to view, inspect and clone anything made in Gorilla's building tools, whether that be questionnaires, tasks, games, shops, or full experiments!

Read more in our Open Materials article about the benefits of publishing your research materials.

Navigate through the menu to the left to learn how to publish your tasks, questionnaires and experiments to the Open Materials repository.

Create an Open Materials Page

Open Materials are created within project folders. To do this:

  1. Navigate to a project folder.
  2. Click the + Create button on the top right.
  3. Select Open Materials Page.
open materials create

Note: You will be able to selectively choose which tasks, questionnaires and experiments you share on the Open Materials Page.

Edit a Page

There are two types of content on an Open Materials page.

  1. Overall information for the Open Material, and
  2. Information pertaining to each specific Material (Task, Questionnaire, Experiment)

To edit an Open Materials Page:

  1. Click Edit on the top right. There will be an on-screen prompt guiding you.
  2. Then click the element to which you want to add content. Clicking on an element will open a modal window into which you can add content.
  3. Once you have added the content, click the green tick on the bottom right of the modal to close it.

Page Fields:

  • Title
  • Description
  • Search Summary
  • Public/Private Setting
  • Citations
  • Conducted At
  • Published On
  • Corresponding Author

Search Summary: This is the information that will appear on the main Open Materials listing page. It is also the field that will be searched within. Describe the materials and include keywords that other researchers are likely to search for. Example: “Non-verbal reasoning puzzles used to test teenagers and adults with ages 12-35. Norms are available in the associated paper.”

Public/Private Setting: Here you can set the visibility of the Materials Page. Public means the page is accessible for anyone with the URL and can be found via the Open Materials search page. Private means the page is only accessible via the URL, so you can send the link to people you want to share the page with such as peer reviewers.

Citations: You can add multiple citations for an Open Material Page and select one as the preferred citation. This is so that you can update the page as your paper makes the journey from pre-print to published paper.

Corresponding Author: You can set any project folder collaborator as the Corresponding Author.

Add a Material

To add a Material:

  1. Click the + Add Materials button at the bottom of the page.
    • This will trigger a modal from which you can select which Material you want to add from a list of all materials from within your project folder.
  2. Complete the relevant material fields.
  3. Once you have added the content, click the green tick on the bottom right of the modal to close it.

Note: You can add several materials (tasks, questionnaires and experiments) to an Open Materials Page.

Material Fields:

  • Name
  • Description
  • Screenshots
  • Search Summary
  • Licence
  • References

Licences: There are 3 licences available.

  • Creative Commons Attribution
  • Creative Commons Attribution Non-Commercial
  • Gorilla Open Materials Attribution Non-Commercial Research Only

References: These are for additional references beyond the overall citation that should be used in conjunction with using this material.

Preview a Page

To preview a page, click on the Preview Version X button on the top right of the page. This will show you a page including your most recent edits, even if they aren’t committed yet.

Your page will also have a unique URL, which is shown under the name of the material. This link will show you the version of the page that was last committed. While unpublished, the page can only be seen by project collaborators that are logged into Gorilla (so that we can authenticate them).

Publish a Page

To publish a material, click the Publish button next to your Open Material’s unique URL. Publishing a material adds it to the main repository listing page and search index. In this way, it ensures that the material can be found by other researchers.

You can also include the Open Material’s unique URL in the methods section of a paper. This will allow researchers to preview, inspect or clone your materials.

Note: Once published, a material cannot be unpublished, but the content can still be edited. For instance, you may want to update the Preferred Citation once your paper is published.

Open Materials Repository

The Open Materials Repository is accessible from the main dashboard in Gorilla. Use the 'Open Science' tab on the main menu along the top and navigate to Open Materials from there. Once in the Open Materials repository, users can browse or search all the published materials.

/open materials repository

Corresponding Author Info

You can set any project folder collaborator as the Corresponding Author. By default, Gorilla Open Materials will only show your name and not your email address.

Configure what information is shown by navigating to My Account > Profile Page.

Profile Fields:

  • Name
  • Role
  • Honorific
  • Job Title
  • Company
  • Lab / Department
  • University / Institution
  • Whether to show you email address on Gorilla Open Materials
open materials corresponding author