Accessing the Manuscript
Once you have accepted a review invitation, OJS moves the assignment to Step 1 of the review workflow. Submission files become available at Step 3 โ Download & Review. This page explains how to locate, download, and organise those files before you begin reading.
The OJS Review Stepsโ
OJS structures the review workflow into four sequential steps:
| Step | Label | What you do |
|---|---|---|
| 1 | Request | Accept or decline the invitation |
| 2 | Guidelines | Read the journal's reviewer guidelines |
| 3 | Download & Review | Download files and read the manuscript |
| 4 | Completion | Submit your recommendation and comments |
You must click Continue at the end of each step to advance.
Downloading Submission Filesโ
- Log in to OJS and go to User Menu โ Dashboard โ My Queue.
- Click the submission title to open the review assignment.
- Click Continue past Steps 1 and 2 to reach Step 3 โ Download & Review.
- Under Review Files, click the filename to download each file.
- Save the files to a dedicated folder on your computer (e.g.,
reviews/journal-name/submission-title/).
Download all listed files before you start reading. Some journals attach figures or datasets separately from the main manuscript.
Types of Files You May Receiveโ
| File type | Typical format | Notes |
|---|---|---|
| Manuscript | .docx, .pdf | Main article text, references, tables |
| Figures / Images | .tif, .png, .eps | High-resolution originals; may be embedded in the manuscript too |
| Supplementary material | .xlsx, .csv, .pdf | Additional data, code, or appendices |
| Cover letter | .pdf, .docx | Author's message to the editor โ may or may not be shared with reviewers |
| Response to reviewers | .docx, .pdf | Appears only in revised submissions |
Not all journals provide all file types. Contact the editor via the Discussion thread if you believe a file is missing.
Double-Blind vs Open Reviewโ
The journal's peer review model determines which metadata you can see:
| Review type | Author names visible? | Author affiliations visible? | Your name visible to authors? |
|---|---|---|---|
| Double-blind | No | No | No |
| Single-blind | No | No | Yes |
| Open | Yes | Yes | Yes |
In a double-blind review, OJS strips identifying information from file names and submission metadata before making them available to you. If you accidentally discover author identity, note it in the Discussion thread and ask the editor how to proceed.
Do not attempt to identify authors in a double-blind review, and do not share manuscript contents outside the review process regardless of the review model.
Opening and Organising Files Locallyโ
Keeping files organised helps you track versions and locate your notes quickly:
- Create a folder named with the journal acronym and submission ID (e.g.,
JOSS-1234). - Do not rename the downloaded files โ the original names often encode metadata used by the journal system.
- Open the manuscript in a PDF reader or word processor with annotation support (e.g., Adobe Acrobat, Microsoft Word, LibreOffice Writer).
- Use tracked changes or sticky notes to mark passages you want to cite in your review rather than transcribing them manually.
- Keep a running notes document (separate from the manuscript) where you record major and minor issues as you read.
Note-Taking While Readingโ
Structured note-taking leads to a more coherent review report:
| Note category | What to capture |
|---|---|
| Summary | Your one-paragraph understanding of the paper's aim and findings |
| Major concerns | Issues that affect the validity or significance of the results |
| Minor concerns | Typographical errors, unclear wording, missing citations |
| Strengths | Aspects done particularly well โ helps authors and editors |
| Line references | Page and line numbers for every specific comment |
Write your summary before listing concerns. Summarising forces you to engage with the paper's core argument and often reveals structural issues more clearly than a line-by-line read.
Further Readingโ
- Learning OJS โ Reviewing โ Step-by-step guide to the OJS review workflow
- COPE Peer Review Guidelines โ Ethical standards and best practices for peer reviewers
- PKP Community Forum โ Ask questions and find answers from the OJS community