Skip to main content
Version: 3.9.x

Get started

Get started in 4 steps

  1. Download JATOS and install a local instance

  2. Open JATOS' GUI by going to localhost:9000 in your browser window

  3. Download and import an example study

    1. Download one of the Example Studies, e.g. the 'Go- / No-Go Task' with jsPsych. Do not unzip the downloaded file.

    2. Import the study into JATOS: Go to JATOS' GUI in your browser and click on Import Study in the header. Choose the .jzip file you just downloaded. The imported study should appear in the sidebar on the left.

  4. Explore the GUI

    In the sidebar click the study to get into the study's page.

    To do a test run of the entire study, click on Run in the toolbar on top of the page.

    If you finished running through the study, you can check the results.

    • To see whole-study results, click on the Results button on the top of the page.
    • To see results from individual components, click on the Results buttons on each component's row.

    For example, you can see each result's details by clicking on the little arrow to the left of its row (more information on how to mangage results).

    Here's a screenshot of a study's results view: Results View screenshot


Now it's time to explore a little bit more.

  • You can click on any component's position button and drag it to a new position within the study.
  • Each component has a Properties button. The component's HTML file may read the data in the field 'JSON data'. This is a way to make changes in the details of the code (wording of instructions, stimuli, timing, number of trials, etc) without having to hard-code them into JavaScript.
  • Where are the actual HTML, JavaScript, and CSS files? They are the files that actually run your study, so make sure you can locate them. All these files, together with any images, sound files, etc. you might have, are called "Study assets". They will be in /path_to_my_JATOS/study_assets_root/name_of_my_study/.