Journal of Statistical Software Submission Process
A practical Journal of Statistical Software submission process guide covering OJS upload, PDF/style checks, software and replication intake, section editor routing, two-reviewer review, and decision paths.
Readiness scan
Find out if this manuscript is ready to submit.
Run the Free Readiness Scan before you submit. Catch the issues editors reject on first read.
How to approach Journal Of Statistical Software
Use the submission guide like a working checklist. The goal is to make fit, package completeness, and cover-letter framing obvious before you open the portal.
Stage | What to check |
|---|---|
1. Scope | Scope check |
2. Package | Formatting check |
3. Cover letter | Editorial screening |
4. Final check | Peer review |
Quick answer: The Journal of Statistical Software submission process is an Open Journal Systems-style upload followed by a hard software-and-reproducibility review. The first process risk is not only whether the manuscript is interesting; it is whether the PDF, source code, replication material, license, metadata, and statistical-software claim are complete enough for a section editor and two reviewers to evaluate.
JSS's official submission entry point is https://www.jstatsoft.org/about/submissions, and the live submission wizard route is https://www.jstatsoft.org/submission/wizard for signed-in authors.
Before upload, run a Journal of Statistical Software process check to test whether the PDF, package, replication script, examples, and journal-fit argument will survive the first process gates. If you need broader fit guidance, use the Journal of Statistical Software submission guide. For the broader journal profile, use the Journal of Statistical Software journal overview. This page owns the after-upload workflow.
What happens in the Journal of Statistical Software submission process?
JSS says authors must provide a PDF manuscript in JSS style, source code, and replication materials for all results from the manuscript. Its step-by-step submission guide describes four upload stages: start the submission, upload the PDF manuscript and additional material, enter metadata, and confirm the submission.
That portal detail matters because JSS is not just receiving a paper file. The author is submitting a reviewable software object: manuscript PDF, code, replication material, license, metadata, and contributor details. In our JSS process reviews, the first process risk is whether those pieces tell one coherent statistical-software story before a section editor has to find reviewers.
For reviewed manuscripts, use a first decision in 4 to 12 months as a planning range, not a promise. Complex packages, uncommon languages, long manuscripts, reviewer availability, and hard replication scripts can move the first decision beyond that range. The useful question before upload is therefore not "can I complete the form?" It is "would a section editor and two statistical-software reviewers be able to evaluate this package without reconstructing the workflow?"
Stage | What happens | What can go wrong |
|---|---|---|
Pre-upload package assembly | Authors prepare the JSS-style PDF, source code, replication materials, license information, metadata, and contributor details | Missing code, missing replication script, non-GPL-compatible license, or non-JSS LaTeX formatting |
Online submission upload | Author starts the JSS submission, uploads the PDF and additional material, enters title/abstract/contributors, and confirms | Wrong file type, incomplete material, metadata mismatch, or missed condition checkbox |
Initial Quality Check | Editors assess whether the submission follows JSS style, attachment, license, and reproducibility requirements | Immediate return for formal problems or unsupported package material |
Editor-in-chief routing | Editor-in-chief selects a section editor | Misfit as documentation, compact software note, pure methods paper, or applied case study |
Section editor and reviewer selection | Section editor selects two reviewers, one of whom can be the section editor | Hard reviewer search for niche software language, rare statistical method, or heavyweight dependencies |
Software and manuscript peer review | Reviewers check correctness, usefulness, documentation, reproducibility, and manuscript explanation | Package install failure, non-reproducible figures, weak statistical contribution, or examples that only show usage |
Decision | Decline, reject, resubmit for review, revision required, or conditional accept | Long revision cycle if code, paper, and replication materials drift apart |
The mistake is treating JSS as a normal journal upload. In JSS, the article, package, and replication material are one scholarly object. A clean manuscript with a brittle package still enters the process weakly.
What should be ready before the JSS upload?
Question | Strong answer | Weak answer |
|---|---|---|
What is the statistical-software contribution? | The abstract and introduction explain the statistical technique, implementation, examples, and advantage over existing tools | The repository works, but the paper reads like documentation |
Can reviewers run it? | A standalone replication script, dependencies, versions, data, seeds, expected outputs, and platform notes are clear | The reviewer must infer setup from the repository |
Does it follow JSS requirements? | PDF is in JSS style, source code is readable, license is GPL-2, GPL-3, or GPL-compatible, and files are upload-ready | LaTeX, license, code, or replication materials are unfinished |
Is JSS the right route? | The paper and software jointly advance statistical computing | JOSS, The R Journal, SoftwareX, CRAN/Bioconductor, or a methods journal owns the real contribution |
If those answers are weak, the process will not fix them. It will expose them during initial checks, section-editor routing, or software review.
How should you build the JSS upload package?
Prepare the full package before opening the online submission flow.
You should have:
- PDF manuscript in JSS style
- LaTeX source and associated manuscript files ready for later production work
- source code for the software in readable ASCII files with comments
- package help files, documentation, examples, and installation instructions
- replication materials for all manuscript results, preferably as a single commented standalone replication script
- data files, download instructions, or external-data links when files are too large for upload
- expected output log, especially for R submissions where JSS recommends a
code.htmloutput from running the replication script - license information showing GPL-2, GPL-3, or GPL-compatible licensing for publication in JSS
- metadata for title, abstract, contributors, affiliations, funding, conflicts of interest, and contact details
This is not just administration. JSS reviewers evaluate correctness and usefulness of both software and manuscript. A missing dependency, a long-running replication script, or an ambiguous license can slow the process before the statistical contribution is even judged.
How do you upload through the JSS online submission flow?
JSS submissions start from the journal's official submissions page. The flow is part of the journal's online Manuscript Tracking System, built around a registered author account and a four-step submission sequence. For manuscripts that clear the first checks, plan for a first decision in 4 to 12 months, with complex software ecosystems, uncommon languages, long manuscripts, or difficult replication scripts pushing reviewed decisions beyond that range.
The step-by-step guide describes the sequence:
- register or log in and ensure the account has the Author role
- start the submission and acknowledge the journal conditions
- upload the PDF manuscript and all additional material
- assign file types for software package, reproduction script, reproduction material, data, or related reference material
- enter title, abstract, contributors, and other metadata
- confirm the submission and finish
The upload step is where many JSS submissions become slow. The system accepts the PDF and additional files, but the editor still has to decide whether the package is reviewable. In our JSS process reviews, the upload fields expose whether the manuscript is controlled: file names, package version, replication script, output log, license, dependencies, and whether the abstract says why the software matters statistically.
What is the Journal of Statistical Software day-by-day timeline?
Use these as planning ranges, not promises. JSS explicitly warns that publication times can be rather long because the journal is volunteer-run and submissions have grown. For manuscripts that pass the formal and fit checks, plan for a first substantive review in months rather than weeks; community author reports often describe long cycles, especially when software review and reproducibility checks are hard.
Process day | Stage | What is being judged | Typical outcome |
|---|---|---|---|
Day 0 to 2 | Submission confirmation | PDF, additional files, metadata, and author account state | Submission recorded or author asked to correct upload details |
Day 2 to 14 | Initial Quality Check | JSS style, PDF-only manuscript upload, source code, replication material, license, file size, and metadata completeness | Administrative pass or return for formal problems |
Day 14 to 45 | Editor-in-chief and section-editor routing | Whether the paper is a JSS statistical-software contribution and which editor can evaluate it | Section editor assigned or editorial decline |
Day 45 to 120 | Reviewer selection and software-review setup | Two reviewers, reviewer availability, software ecosystem, dependencies, replication burden, and code language | Reviewer invitations, added search, or delay |
Month 4 to 12+ | Software and manuscript review | Correctness, usefulness, reproducibility, documentation, examples, statistical contribution, and manuscript clarity | Decline, reject, resubmit for review, revision required, or conditional accept |
The calibrated range is therefore: upload and formal checks can move quickly, editor routing may take weeks, and full review can take many months because two reviewers evaluate the software and manuscript. If the package uses a less common language, has heavyweight dependencies, or lacks an easy replication path, JSS itself warns that authors may need to accept longer review times.
What happens during Initial Quality Check and administrative intake?
JSS's submission preparation checklist is unusually concrete. Submissions may be returned if authors do not adhere to the guidelines.
Common intake delays:
- PDF manuscript is not in JSS style
- source code for the software is missing or hard to read
- replication materials do not cover all manuscript results
- license is unclear or not GPL-compatible
- file size exceeds the 50 MB upload limit without external download instructions
- long manuscript exceeds 30 pages and creates predictable review-time drag
- metadata, contributors, funding, conflict-of-interest, data availability, authorship, or author-contribution details are inconsistent
- platform dependencies are not disclosed
Fix these before upload. An administrative return is not fatal, but at JSS it is expensive because the queue is already slow.
How does editor routing and scope fit work?
After the package clears formal intake, the editor-in-chief selects a section editor. The section editor then selects two reviewers, one of whom can be the section editor.
The first routing question is not "does the software run?" It is "is this a JSS paper?" The official guide says the typical JSS paper explains the statistical technique, the code, the actual code use, and examples, with careful discussion of existing implementations and the advantages and disadvantages of the contribution.
Strong process signals:
- abstract states the statistical-computing contribution, not only the package name
- manuscript explains the technique, implementation, examples, and comparison to alternatives
- source code is readable, documented, licensed, and package-ready
- replication materials regenerate tables, figures, simulations, and empirical examples
- examples show statistical value rather than only command syntax
Weak process signals:
- repository works but manuscript reads like package documentation
- method is solid but software is thin or unmaintained
- examples demonstrate usage without a statistical reason to care
- replication script needs manual edits, hidden data, or undocumented dependencies
- contribution belongs more naturally in JOSS, The R Journal, SoftwareX, CRAN/Bioconductor, or a methods journal
This is why the submission-process page is separate from the submission guide. The guide helps decide whether JSS is the target. The process page explains how the uploaded package is routed and reviewed.
In our pre-submission work with Journal of Statistical Software manuscripts: named editorial failure patterns
Journal of Statistical Software triage is a paper-plus-software screen. Manuscripts that look like documentation, unreproducible packages, or method papers with a repository attached can leave the process before the authors get the review they expected.
Methodology note: this page was created from official JSS source checks, sibling-page overlap checks, and Manusights submission analysis of statistical-software manuscripts. In our analysis of JSS submission packages, the fastest process failures are visible before peer review. We evaluate the same components a section editor and software reviewers see early: abstract, introduction, examples, PDF, package files, replication script, license, documentation, and metadata.
Working software without a statistical contribution. This pattern appears when the repository is useful but the abstract and first section never explain the statistical technique, computational workflow, model class, diagnostic, simulation design, visualization, or inference problem that the software advances. JSS is not only checking whether commands run. It is checking whether the paper and software jointly advance statistical computing.
Check whether your JSS abstract states a statistical-software contribution →.
Replication material is present but not reviewer-complete. A zip file, data folder, or script is not enough if a reviewer cannot regenerate the manuscript results. The replication package should define dependencies, versions, seeds, expected outputs, runtime, platform notes, and external data. A reviewer should not have to reverse-engineer the workflow from the repository.
Check whether your JSS replication package is reviewer-complete →.
Examples show usage but not statistical value. A tutorial-style example can make the package look usable while leaving the scholarly contribution unclear. JSS examples should show why the software improves analysis, inference, diagnostics, simulation, visualization, or pedagogy compared with existing tools.
Check whether your JSS examples prove statistical value →.
The venue route is wrong. JOSS, The R Journal, SoftwareX, CRAN/Bioconductor, PyPI, Statistics and Computing, Computational Statistics, or Journal of Computational and Graphical Statistics may be better depending on whether the center is open-source software, R-community communication, software artifact, package review, or statistical method.
Our analysis of JSS submission packages treats triage as a document-and-code test. The manuscript component that fails first is usually visible before review: abstract claim, examples, package documentation, replication completeness, license clarity, or target-journal premise.
The practical pattern is specific to Journal of Statistical Software. A package can be useful and still enter the process weakly if the manuscript does not prove statistical-software value. We look for whether the abstract names the statistical problem, the introduction compares existing implementations, the examples demonstrate value, the replication script regenerates every result, and the documentation matches the paper.
We also inspect the cover letter and metadata for a journal-specific sentence: why this manuscript belongs in JSS rather than JOSS, The R Journal, SoftwareX, CRAN/Bioconductor, Statistics and Computing, Computational Statistics, or a methods journal. If that sentence is vague, the process often slows because the editor has to reconstruct the target fit.
The reviewer-count expectation is concrete. JSS says the section editor selects two reviewers, one of whom can be the section editor, and that both software and manuscript are reviewed. The review tells you whether your paper passes the same process screen editors and reviewers look for before the long review cycle starts. A paid Manusights review applies that same division before submission: statistical contribution, package usability, reproducibility, journal fit, and reviewer-risk checks. Paid reviews include the 60-day money-back guarantee, and Manusights does not train models on submitted manuscripts. We do not train on submitted manuscripts.
Readiness check
Run the scan against the requirements while they're in front of you.
See score, top issues, and journal-fit signals before you submit.
How does software and manuscript peer review work?
JSS peer review is not open peer review or a GitHub issue-style collaborative review like JOSS. It is a conventional editor-and-reviewer process with a software artifact at the center. The distinguishing feature is not single-blind visibility; it is that the reviewers evaluate both the software and the manuscript.
Reviewer assignment can slow when:
- software is written in a less common language
- the method spans statistics, machine learning, visualization, optimization, and domain science
- installation requires compiled libraries, system dependencies, or large external data
- replication takes longer than a reasonable reviewer run
- suggested reviewers are too close to the authors or too narrow in ecosystem
Once reviewers agree, they test correctness, usefulness, documentation, reproducibility, examples, and whether the manuscript explains the statistical contribution clearly.
What decision and revision paths can follow review?
JSS names five main decision paths.
Decision type | What it means | Author response |
|---|---|---|
Decline | Editorial reject before review or early in process | Retarget or rebuild the package/paper before another journal |
Reject | Rejected after review, possibly after revision | JSS says rejected manuscripts cannot be resubmitted |
Resubmit for review | Revision will go back to both reviewers and editor | Fix the paper, package, replication script, and documentation together |
Revision required | Revision goes back only to editor | Answer every point and keep the package aligned with the paper |
Conditional accept | Accept depends on final manuscript, style, and reproducibility compliance | Deliver final files that satisfy JSS style and reproducibility requirements |
Every revision must include a point-to-point reply to reviewers and editors. If a revision is not received within six months, JSS says the paper will be considered withdrawn. If a conditionally accepted paper is not brought into final form within a year, it will also be considered withdrawn.
How long does the JSS process take?
Time since submission | Normal signal | Concerning signal |
|---|---|---|
Day 0 to 14 | Upload, metadata check, PDF/style review, attachment completeness | Return for missing code, license, replication material, or JSS-style PDF |
Week 2 to 8 | Editor-in-chief and section-editor routing | Misfit as documentation, pure method, or compact software note |
Month 2 to 6 | Reviewer search and software-review setup | Niche software language, hard dependencies, conflicted reviewer pool |
Month 4 to 12+ | Full software and manuscript review | Package install failure or reproducibility failure extends the round |
Month 6 to 18+ | Revision, re-review, conditional acceptance, and final production | Code, paper, and documentation drift apart during revision |
The strongest author-controlled time saver is not a status email. It is a package that installs, a replication script that runs, examples that show statistical value, and a paper that is already in JSS style.
When should you submit?
Submit to Journal of Statistical Software when:
- the paper and software jointly advance statistical computing
- the PDF is already in JSS style
- source code is readable, commented, licensed, and package-ready
- replication materials regenerate every result from the manuscript
- examples demonstrate statistical value, not only usage
- dependencies, versions, seeds, platform notes, and expected outputs are documented
- the cover letter explains why JSS is a better target than JOSS, The R Journal, SoftwareX, CRAN/Bioconductor, or a methods journal
Think Twice If
Hold the submission when:
- the abstract reads like package documentation rather than a statistical-computing contribution
- Figure 1 and the main examples show usage, but no figure, table, or simulation demonstrates statistical value
- the replication script cannot regenerate the main table, figure, method comparison, or simulation from a clean environment
- the methods section hides dependency, version, platform, seed, or computational-burden details
- the source code lacks readable comments, help files, or package-level documentation
- the license is not GPL-2, GPL-3, or clearly GPL-compatible
- the paper would be clearer as a compact JOSS submission, R Journal article, SoftwareX article, package-review submission, or statistical-methods paper
The process is fastest when the manuscript is honest about its center. JSS is not the right destination for every useful software package.
Pre-submission checklist before you click submit
Run this final process checklist:
- [ ] PDF manuscript follows JSS style.
- [ ] Abstract names the statistical problem and software contribution.
- [ ] Source code is included, readable, commented, and licensed.
- [ ] Replication materials regenerate every table, figure, simulation, and empirical example.
- [ ] Dependencies, versions, seeds, platform notes, and runtime expectations are documented.
- [ ] Examples demonstrate statistical value rather than only commands.
- [ ] Metadata, contributors, funding, conflicts, and contact details are ready.
- [ ] File sizes fit the upload limit or external download instructions are prepared.
- [ ] Cover letter explains JSS fit rather than advertising the repository.
- [ ] The package would still look coherent if a reviewer installed it before reading the full paper.
Before submitting, run a Journal of Statistical Software process check to catch software, reproducibility, and fit signals that slow the process or trigger an early negative decision.
Frequently asked questions
Submit through the official JSS online submission flow after registering as an author. The four-step flow covers starting the submission, uploading the PDF manuscript and additional files, entering metadata, and confirming the submission.
After upload, JSS checks the PDF, source code, replication materials, license, and metadata, then the editor-in-chief selects a section editor. The section editor selects two reviewers, one of whom can be the section editor, and both the software and manuscript are reviewed.
JSS warns that publication times can be rather long because the journal is volunteer-run and submissions have grown. Plan for weeks to months before substantive review and potentially many months for first review when reviewer availability, software language, package size, or reproducibility problems complicate the process.
Common stalls include non-JSS LaTeX formatting, missing source code, incomplete replication materials, software without a GPL-compatible license, long manuscripts, hard-to-install packages, unclear statistical contribution, and examples that do not reproduce within a reasonable reviewer workflow.
JSS reviews both. The official author information says the software and manuscript are peer reviewed by the statistical software community, and reviewers evaluate correctness, usefulness, documentation, and reproducibility.
Sources
- JSS Information for Authors - official JSS page checked July 16, 2026 for journal model, required attachments, software preparation, manuscript preparation, review process, decisions, revision rules, and journal information.
- JSS Submission Guide - official step-by-step guide checked July 16, 2026 for paper types, submission requirements, upload steps, metadata entry, confirmation, and revised-material upload.
- JSS Submissions page - official submissions page checked July 16, 2026 for submission checklist, license requirements, author guidelines, copyright notice, and submission entry point.
- JSS editorial team - official editorial-team page checked July 16, 2026 as the current source for editor names if authors personalize a cover letter.
Before you upload
Choose the next useful decision step first.
Move from this article into the next decision-support step. The scan works best once the journal and submission plan are clearer.
Use the scan once the manuscript and target journal are concrete enough to evaluate.
Anthropic Privacy Partner. Your manuscript is never used to train any model.