American Economic Review Response to Reviewers: An R&R Evidence Guide
An AER revision guide for organizing editor priorities, contribution, identification, robustness, self-contained evidence, and reproducibility.
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 use this page well
These pages work best when they behave like tools, not essays. Use the quick structure first, then apply it to the exact journal and manuscript situation.
Question | What to do |
|---|---|
Use this page for | Building a point-by-point response that is easy for reviewers and editors to trust. |
Start with | State the reviewer concern clearly, then pair each response with the exact evidence or revision. |
Common mistake | Sounding defensive or abstract instead of specific about what changed. |
Best next step | Turn the response into a visible checklist or matrix before you finalize the letter. |
Quick answer: An American Economic Review response to reviewers should be an editor-led argument about what the revised paper now contributes and identifies, followed by a complete point-by-point record. For every change, cite the exact page and line, equation, table, figure, or appendix. Align the response with the self-contained manuscript and the AEA data-and-code package: if a robustness test changes the estimate, mechanism, or external-validity boundary, update the abstract and contribution claim rather than burying the result in an online appendix.
Use the AER R&R readiness scan before resubmission. Initial requirements live in the AER submission guide; editorial-status interpretation belongs to the AER under-review guide, and the AER journal profile supports comparison.
How we researched this guide: we reviewed the current AER author and referee guidance, the AEA data-and-code policy, established rebuttal-craft guidance, and anonymized manuscript patterns from Manusights revision checks. Use this guide to turn the decision letter into an auditable evidence plan before the editor and referees receive the revision.
Turn the decision letter into an AER revision specification
Do not begin by drafting replies in referee order. Extract the editor's decision-controlling issues first. AER referee reports can contain dozens of requests, but several often test the same concern: whether the contribution is distinct, whether identification supports the causal language, whether the model explains the result, or whether an empirical pattern survives credible alternatives.
Controlling issue | Evidence to assemble | Claim to re-audit |
|---|---|---|
Contribution | Revised positioning, comparison with closest work, economic magnitude | Abstract, introduction, conclusion |
Identification | Assumptions, design tests, diagnostics, falsification, sensitivity | Causal verbs and policy interpretation |
Mechanism | Predictions that distinguish competing channels | Theory section and mechanism language |
Robustness | Prespecified alternatives tied to plausible threats | Headline estimate and heterogeneity claims |
Generality | Population, setting, equilibrium, or institutional boundary | External-validity statements |
Reproducibility | Data provenance, code, README, environment, output mapping | Tables, figures, and computational claims |
The response should show how individual requests changed this architecture. It should not read like a disconnected changelog.
Copyable AER response-to-referees template
Keep editor and referee text in bold or clearly labelled boxes, with author responses in regular text. Use exact revised-manuscript locations.
Dear Editor,
Thank you for inviting a revision of manuscript AER-2026-1184,
"Procurement Transparency and Municipal Investment." Your letter identified
three controlling questions: whether the design identifies the procurement
effect, whether the mechanism is distinguishable from fiscal selection, and
whether the contribution extends beyond the closest disclosure studies. We
address each below, then respond to every referee point.
Comments are in bold; page and line references use the revised manuscript.
Editor issue 1: Identification
Response: We added the design diagnostic in new Figure 2, a placebo test
in Table 3, and sensitivity to differential pre-trends in Appendix Table A5.
The revised
estimand and assumptions appear on page 8, lines 4-31. The abstract now
describes the result as a local policy effect, not a universal causal claim.
Referee 1, Comment 3
"The identifying variation may capture differential pre-trends."
Response: We agree this was not resolved by the original graph. We now
report event-time estimates, group-specific trends, and the requested
pre-period test. See Figure 2 and page 9, lines 2-24. The main estimate
is 7.4 percent, with the stated limitation.
Referee 2, Comment 1
"The mechanism is observationally equivalent to fiscal selection."
Response: We derive the distinct prediction in revised Section III and
test it using staggered disclosure timing. The result is in Table 5; see
page 15, lines
7-29. We removed the mechanism claim where the test cannot distinguish it.
Referee 3, Comment 4
"The results are difficult to reproduce from the current description."
Response: We rebuilt the package with a top-level README, environment
file, data provenance, and one command that recreates all tables and
figures. The manuscript's data statement is on page 27, lines 3-15.
Sincerely,
Dr. A. Economist, on behalf of all authorsIf the editor's letter gives a different priority than a referee report, do not conceal that hierarchy. Address both, but organize the opening around the editor's specification.
The page-line-equation rule
Every reply should identify the changed page and line. For formal or empirical material, add the proposition, equation, figure, table, or appendix. A response such as "we added robustness checks" is not auditable; name the threat each check targets and the result it produces.
AER asks that essential methods, variable definitions, data sources, and formal proofs remain in the self-contained paper rather than requiring the reader to consult a supplemental appendix. That boundary matters in revision. Do not answer a central identification concern only with a large appendix table and leave the main paper unchanged.
Rebuild the response locations after final pagination. Equation and appendix numbers frequently shift during a large economics revision.
Typography for editor and referee text
Use a stable distinction: comments in bold or shaded blocks, responses in regular text, and explicit labels for Editor, Referee 1, Referee 2, and Referee 3. Avoid a color-only scheme.
Use the bold font and labels to distinguish each reviewer comment from the author response even when the PDF is printed in grayscale. That visual rule should remain consistent in every section.
Long economics reports often contain nested comments. Preserve their hierarchy. If you divide one comment into parts 2a, 2b, and 2c, reproduce enough of the original wording that the referee recognizes each part and can verify your answer without searching the old report.
The AER referee culture you are writing into
AER revision review combines broad contribution judgment with high methodological rigor. The editor synthesizes reports, while referees may focus on design, theory, measurement, or institutional context. Your opening letter should therefore explain how those specialist requests now support one general-interest economics contribution, not several parallel papers.
The response is strongest when it lets the editor distinguish a resolved validity concern from an optional extension. Referees can reasonably disagree about preferred specifications; the editor needs a coherent account of which evidence is decisive and why the revised claim stops at the supported boundary.
Map common referee requests to identification threats
Request | Threat it may represent | Useful answer |
|---|---|---|
Add pre-trends | Differential dynamics or anticipation | Event-time evidence plus design-specific limits |
Add controls | Omitted variables or composition | Explain selection logic; avoid a specification kitchen sink |
Add an instrument | Reverse causality or measurement error | Defend relevance/exclusion and report weak-identification evidence |
Add another sample | External validity or precision | Choose a sample that changes the relevant institution or population |
Add heterogeneity | Mechanism or incidence | Prespecify dimensions, test interactions, control multiplicity |
Add a structural model | Counterfactual or equilibrium interpretation | Show why reduced-form evidence cannot answer the requested object |
Release code | Reproducibility | End-to-end package with provenance and output mapping |
An requested method is not automatically the right answer. Identify the threat, then choose the design or analysis that actually addresses it.
Tone calibration for AER responses
Avoid | Better |
|---|---|
"The referee is wrong about identification." | "The original text did not separate the two threats. We add the design diagnostic in Figure 2 and narrow the causal interpretation on page 10." |
"These controls are standard." | "We define the control set from the assignment process and report sensitivity to the plausible confounders in Table 3." |
"The result remains significant." | "The estimate changes from 9.1 to 7.4 percent, with the interval shown in Table 4; the conclusion is now limited to treated municipalities in the study period." |
"The mechanism is obvious." | "We derive a prediction that differs from fiscal selection and test it in Table 5; where the test is not discriminating, we remove the mechanism claim." |
"The code will be cleaned after acceptance." | "The revision package now runs end to end and maps every output to the corresponding table or figure." |
Statistical significance is not a response to design validity. Report magnitude, uncertainty, and what the new analysis changes about the economic conclusion.
In our pre-submission review work with AER revisions
In our pre-submission review work with American Economic Review manuscripts and revisions, we connect each response to the design code, analysis output, manuscript claim, and replication documentation. We audit every controlling issue across those artifacts and observe where the revised inference still depends on an old result or undocumented step. That cross-artifact review is necessary because a long economics rebuttal can look rigorous while the identifying assumption, economic magnitude, or computational path remains unchanged. These anonymized manuscript patterns are not AER editorial records or access to referee deliberations. Each is testable from an author's own response, revised paper, and data-and-code package.
A robustness appendix that never states the threat. American Economic Review revisions sometimes add twenty specifications without explaining which one tests selection, measurement, functional form, or equilibrium spillovers. The response becomes longer without making identification stronger. We route each table and figure to one threat, record the result and consequence, and remove redundant variants that do not change the inference.
A mechanism asserted through heterogeneity. In an American Economic Review response, an effect may be larger in one subgroup and then be called proof of a channel. Unless competing mechanisms predict different patterns, heterogeneity is compatible with several stories. A credible response derives a discriminating prediction or labels the evidence descriptive, then updates the introduction and conclusion to use the same boundary.
A changed estimate with an unchanged contribution paragraph. New data cleaning, sample restrictions, or design corrections move the magnitude materially, but the abstract still carries the original number and policy interpretation. Returning referees notice the high-salience mismatch before reading the appendix.
A replication package that reproduces only the final regression. Data construction, exclusions, intermediate merges, random seeds, or figure scripts remain manual. The AEA Data Editor needs a traceable path from permitted inputs to published outputs. Treat provenance and environment as scientific documentation.
Our final Sullivan-style test asks whether another author could infer the same identification claim from the reported design and reproduce the published tables without private explanation from the team. When the answer is no, the response still depends on tacit knowledge and is not ready for the same editor and referees.
Scan the revised AER argument, response, and reproducibility package as one system before resubmission.
When to push back on a referee request
Push back when a requested design estimates a different object, relies on an indefensible assumption, or would move the paper away from the contribution the editor invited. State the underlying concern first, then offer a better test.
For example, a reviewer may request an instrumental-variable estimate to address reverse causality. If the proposed instrument lacks a credible exclusion restriction, do not add it as decoration. Strengthen the existing design, add a targeted sensitivity analysis, and state the remaining causal boundary.
Reconcile the manuscript with the data and code package
Before acceptance, empirical, simulation, and experimental work must comply with AEA data-and-code policy. Use the revision to create:
- a top-level README with the computational sequence;
- provenance and access notes for each input;
- an environment or dependency specification;
- deterministic seeds where randomness is used;
- a crosswalk from scripts to every table and figure;
- documented handling for confidential or restricted data;
- a clean run that starts from the permitted inputs.
If data cannot be shared, follow the policy's documentation and preservation requirements. Do not imply public availability where legal access is restricted.
Where AER revisions fail
Most rejection-on-revision risk comes from a controlling issue that accumulated analyses but did not become more credible. The response is long, yet the identifying assumption, distinct contribution, or mechanism remains unchanged. Another common failure is hiding a changed result in an appendix while preserving the original headline.
An R&R is not acceptance. If a new analysis contradicts the original interpretation, revise the paper around the result you can support. Editors can evaluate a narrower true contribution; they cannot rely on a response that treats contradiction as a robustness check.
Submit if; think twice if
Submit if: the editor's controlling issues have completed evidence, each robustness analysis names its threat and consequence, mechanism language is discriminating rather than decorative, and the replication path reaches every published output. The abstract should already reflect every material change.
Think twice if: causal language still outruns the design, an appendix absorbs the central answer, or the data-and-code package depends on undocumented manual steps. Resolve the identification or reproducibility boundary before returning the revision.
Readiness check
Run the scan to see how your manuscript scores on these criteria.
See score, top issues, and what to fix before you submit.
Final AER response audit
- Extract the editor's controlling issues before drafting replies.
- Map every referee request to contribution, identification, mechanism, or generality.
- State the result of each new analysis, not only that it was run.
- Update abstract, introduction, tables, and conclusion after material changes.
- Keep essential evidence and proofs in the self-contained paper.
- Cite page, line, equation, figure, table, and appendix locations.
- Distinguish editor/referee comments from author responses visually.
- Build the data-and-code package during revision.
- Verify every response location after final typesetting.
- Recheck AER journal fit if the revised contribution changes materially.
This guide was reviewed on July 12, 2026. AEA sources define policy; the issue-to-evidence framework is Manusights analysis.
Frequently asked questions
Start with a letter to the editor that maps each decision-controlling issue to a completed revision. Then answer the editor and every referee comment in order. Quote the comment, state the action and result, and cite the exact page, line, equation, table, figure, or appendix. Keep the response consistent with the revised manuscript and data-and-code package.
Prioritize the editor's synthesis: the economic contribution, identification, model or design credibility, robustness, and interpretation. A long list of requested checks should be organized around those controlling questions rather than treated as unrelated tasks.
Yes. Restate the concern precisely, show the relevant economic or statistical argument, provide a targeted analysis where possible, and narrow the claim when uncertainty remains. Do not rely on another referee's opinion or the authors' standing.
AER submissions must comply with the AEA Data and Code Availability Policy. Before acceptance, papers with empirical, simulation, or experimental work must provide sufficient data, code, and computational detail for replication. Treat reproducibility as part of the revision rather than a last-minute deposit.
Sources
- 1. AER submission guidelines (accessed July 12, 2026)
- 2. AER reviewer guidelines (accessed July 12, 2026)
- 3. AEA Data and Code Availability Policy (accessed July 12, 2026)
- 4. Ten Simple Rules for Writing a Response to Reviewers, PLOS Computational Biology (accessed July 12, 2026)
- 5. How to respond to reviewers, Nature Computational Science (accessed July 12, 2026)
Final step
Find out if this manuscript is ready to submit.
Run the Free Readiness Scan. See score, top issues, and journal-fit signals before you submit.
Anthropic Privacy Partner. Zero-retention manuscript processing.