User guide
Reviewing a manuscript in RevieWell
Guidance for reviewers and editors, plus steps to try when something goes wrong.
Reviewer guide
Sign in and open Your workspaces. Choose a workspace, then open a manuscript. If none appear, ask your workspace administrator about editor access.
Before making decisions, open the Checklist in the Review tab. Read what the analysis checked and what it could not check. A disabled check, or one with too little evidence, has not passed.
Select a finding to highlight its passages in the manuscript text. Choose Show in text to jump to a passage; use [ and ] to move between passages. PDF view highlights them on the page. Your original file is unchanged.
For each finding, choose Confirm finding, Ask authors to clarify or Dismiss finding, or press C, R or D. Decisions save immediately; choose Undo within 10 seconds to reverse one. You can also add a note. Write your overall assessment in English in the Report tab. It is saved when you see “Assessment saved.”
Decide on every finding; Unreviewed shows any that remain. Then open the Report tab, review the limitations and select Submit review. Submitted reviews can’t be changed. You can download the submitted report as HTML, print or save it as a PDF, and copy the assessment.
Editor guide
Before starting an analysis, open Templates and review the rules for the journal and article type. Additional content checks are off by default. Open each check and read its limits before turning it on. Each analysis uses the template version selected when it starts.
During the alpha, select Try an alpha sample to add a sample manuscript. On its page, choose a journal and article type, then select Start analysis. Uploading your own PDF or DOCX will be available after the alpha.
After analysis finishes, open Review to record your decisions and notes. Editors can review directly.
The manuscript list shows your review’s status. Use Submitted reviews to find manuscripts with submitted reports. Other people’s drafts stay private.
Open a submitted report to read the decisions, assessment and source passages. Reports remain available to editors if the author loses workspace access. Submitted reviews stay read-only.
When something goes wrong
A save or submission failed
Keep the page open and select Retry next to the message. Your text will remain on screen. If there’s no saved confirmation, assume your changes haven’t been saved. If copying fails, select and copy the text manually.
The assessment changed in another tab
Compare your text with the saved assessment, then choose Use saved assessment or Keep my assessment. If the review was submitted in another tab, copy anything you want to keep before leaving. Submitted reviews can’t be changed.
A document or workspace will not open
Select Refresh access or Refresh review. If your access was removed, contact your workspace administrator. Signing in again does not restore permissions.
The analysis failed or found nothing
Read the message on the manuscript page and check which parts of the analysis ran. No findings does not mean the manuscript is accurate. Some checks may have been disabled or unable to run.
Questions
Can I use the keyboard?
Yes. Use Tab and Shift+Tab to move between controls, then Enter or Space to activate a button. On the review screen, J and K move between findings; C, R and D record a decision; N opens a note. Show in text moves focus to the passage so you can keep reading.
Which languages can I use?
The interface and sample summaries are available in English and Korean. Findings and source passages remain in the manuscript’s language. Assessments are written in English.
Who can see my unfinished review?
Your decisions, notes and assessment remain private until you submit. Submission makes the review read-only and visible to editors.
How do I get into a workspace?
Sign in and accept your organization’s invitation. Ask your workspace administrator for editor access to upload and review manuscripts.