River
Y CombinatorBacked by Y Combinator

Research & PolicyFree tool

Thematic Analysis Write-Up With Evidence

A results section and methods paragraph from your coded extracts, with every theme checked first for who is behind it and what contradicts it.

Helpful to include

Free to start · Opens in your River workspace, ready to edit and share

How to write up a thematic analysis

To write up a thematic analysis, test your themes against the data first, then give each one its own section of the results. A good write-up opens with an overview of the themes, names each as a claim, defines its central idea, and argues it with quotes from several participants. It keeps the cases that don't fit, and its methods describe what you actually did.

Test before you write. Two vivid quotes from one talkative participant look just like a pattern shared across 14 interviews, and no reader can tell them apart. You can, by checking who stands behind each theme.

Rows of yellow, green and orange sticky notes covered in handwriting, laid out on a large sheet of paper
Codes sorted into clusters are only candidate themes until you test them. Photo: Yen Vu on Unsplash

Name the kind of thematic analysis you did

Thematic analysis is a family of methods, and your write-up has to match the one you used. Psychologists Virginia Braun and Victoria Clarke, who set out the six-phase approach in 2006, distinguish three main types1, and each changes what you report.

  • Reflexive: themes are patterns of shared meaning you build from your own codes, with no codebook and no agreement score.
  • Codebook, such as framework or template analysis: themes are set early, often around topics, and the data are charted against them.
  • Coding reliability: independent coders apply a structured codebook, and you report their agreement with a statistic such as Cohen's kappa.

Mixing approaches without saying so is common. In a 2024 review of 20 papers in the journal Palliative Medicine that cited their work, Braun and Clarke found some degree of methodological incoherence in every one2.

Short answers to an open survey question are often coded with a codebook and counted instead. Coding open-ended survey responses walks through that job.

Test every theme before you write it

Braun and Clarke's fourth phase is checking the candidate themes against the coded data and the entire dataset3. Do it in a sheet, not in your head, so you can show your work.

  1. State the central idea

    Write what the theme claims. If you can't describe its scope and content in a couple of sentences4, Braun and Clarke say it may need more refining.

  2. Count who is behind it

    Note how many participants contributed, and how many extracts came from the top contributor. Braun and Clarke warn against themes built from a few vivid examples1.

  3. Look for contradictions

    Search the rest of the data for extracts that complicate or limit the claim. If you find none, record where you looked.

  4. Decide what it is

    Keep it, make it a subtheme, rename it as a claim, dissolve it into its codes, or report it as one person's account.

A grid of participants by candidate themes makes this quick. Nicola Gale and colleagues note that the framework method's matrix of participants by codes can draw attention to contradictory data, deviant cases or empty cells5.

Six candidate themes, tested

Candidate themeParticipants (of 14)Top contributor's extractsContradicting extractsVerdict
The conversation waits for a quiet hour136 of 415Keep
Whose decision is it?127 of 386Keep, renamed: Nobody owns the decision to stop
A doctor's silence reads as a no115 of 294Keep
Fear of the difficult conversation96 of 263Subtheme, renamed: Raising it means owning it
Benefits of the new service104 of 220Dissolve: it names a topic, not a claim
Pharmacist as gatekeeper39 of 120Report separately: mostly one participant's account

An illustrative study: 14 interviews with community pharmacists about stopping medicines for older patients, 168 coded extracts. No extract is discarded, only reclassified.

Count to test, not to persuade

In reflexive work, Braun and Clarke generally advise against reporting percentages. If 12 of 20 men raised something, the other eight may simply not have discussed it1. Keep counts in your audit and describe spread in words.

Open the results with a map of the themes

Begin with an overview of the themes and subthemes. APA's reporting standards for qualitative research suggest synthesizing illustrations such as diagrams, tables or models6 where they help.

For a journal article, a master's dissertation or one analytic chapter of a doctoral thesis, Braun and Clarke consider two to six themes, including subthemes1, about right. Use subthemes sparingly, for one facet of a theme that deserves emphasis.

Order the themes so each builds on the last, and keep background that isn't a theme in the participant description.

Write each theme as an argument

Give each theme a section: the claim as its heading, its central idea in a sentence or two, then a narrative carried by extracts. Braun and Clarke's 2006 paper says extracts need to be embedded within an analytic narrative4 that argues something about your research question.

Choose extracts that show the claim plainly, spread them across participants, and label each with an ID such as P7. Then say what each one shows. APA's standards say quotes should not replace the description of the findings6.

ExampleOne theme, written upAn illustrative example written for this guide

Nobody owns the decision to stop

Almost every pharmacist described stopping a medicine as someone else's call: the prescriber's, the patient's or a relative's. That uncertainty, more than any knowledge gap, kept the conversation from starting.

"It's not my prescription. If I say stop and she falls, that's on me." (P4)

"Her daughter does the tablets, so really it's up to her and the GP." (P9)

Subtheme: Raising it means owning it. Naming the problem felt like taking responsibility for whatever happened next.

Two pharmacists with booked review appointments described the decision as plainly shared (P2, P11). Having a set time and place may change who owns it.

  • A claim in the heading. Anyone skimming the headings still learns the finding.
  • Spread in words. "Almost every pharmacist" gives the reach without a percentage, and the quotes come from different people.
  • The exception stays in. The booked-review pharmacists mark the claim's limits, inside the theme.

Quote exactly, and mark every change

Copy each quote as transcribed. If you trim hesitations for readability, say so in your methods. Put any word you add in square brackets, show cuts with an ellipsis, and remove names and places that could identify someone.

Keep the cases that don't fit

Put contradicting extracts inside the theme they complicate, not in a limitations paragraph at the end. APA's standards ask for findings that make sense of contradictions or disconfirming evidence6, for instance by explaining why a conflict might exist.

A candidate resting on one or two people can still matter. Report it under its own heading as an individual account, stating its narrow base plainly.

Describe what you actually did

Write the methods from your notes, not from the textbook. In the paper introducing their reporting guidelines (RTARG), Braun and Clarke ask authors to report not the generic phases but their specific engagement, process and decisions2. Say who coded, how you tested candidates, and which you merged, renamed or dissolved, and why.

Add a few sentences on your background and assumptions, and how they shaped the analysis. In reflexive work, don't say themes "emerged"; you developed them. Skip saturation and worries about researcher bias too: Braun and Clarke describe both as founded in (post)positivism and incoherent with reflexive thematic analysis2.

Many journals require a reporting checklist at submission. COREQ, a 32-item checklist for interviews and focus groups7, is widely used. For reflexive work, Braun and Clarke propose RTARG instead.

If a reviewer asks for something your approach doesn't use, such as a kappa, explain why in your response to reviewers instead of bolting it on.

Before you submit

  • Your approach is named, and everything you report fits it
  • Every theme was checked against the whole dataset
  • Theme names state claims and match the overview
  • Each theme has a central idea and quotes from several participants
  • Contradicting extracts sit inside their themes
  • The methods describe what you did, not the six phases

Your discussion then sets each theme against earlier studies, which a literature review synthesis helps you map. River, the tool at the top of this page, tests each candidate theme against your coded extracts, then drafts your results and methods.

How it works

Start by attaching your coded extracts, with participant IDs, and your research question. River tests each candidate theme before writing a word: who is behind it, how much comes from its top contributor, and which extracts contradict it. Then it writes the results section and a methods paragraph in your workspace, with an audit sheet showing every verdict.

It builds themes only from your codes and quotes every extract exactly as transcribed, never invented or tidied. Candidates that don't hold up are reclassified in plain view, not quietly dropped, and you can argue with any verdict in chat.

  1. Attach your coded extracts

    Upload your coded export with participant IDs, add your research question, and choose your approach if you know it.

  2. River tests each theme

    It counts who is behind each candidate and how much comes from one person, then searches for contradicting extracts.

  3. Get your results section

    Themes with definitions, quotes from several participants and contradictions in place, plus a methods paragraph and audit sheet.

  4. Argue and revise

    Defend a rejected theme, split one that carries two ideas, or check the draft against COREQ.

What you get

  • A results section with a part for each theme: its claim, central idea, narrative and verbatim quotes
  • An audit sheet giving each candidate's participant spread, top contributor's share and contradicting extracts
  • Contradicting extracts quoted inside each theme, or a note of the codes and transcripts searched
  • A verdict on every candidate: keep, fold in as a subtheme, rename, dissolve or report separately
  • Every theme mapped to its extracts and the participant behind each one, in a sheet you can check
  • A methods paragraph describing the theme development River actually did, ready to adapt for your manuscript

Common questions

How many themes should a thematic analysis have?

Usually two to six, counting subthemes, for a journal article, a master's dissertation or a single thesis chapter. That is Braun and Clarke's rule of thumb rather than a requirement, and fewer themes leave room for depth. If you have 10 or more, check whether some are codes or topics that belong inside a larger theme.

Should I report how many participants mentioned each theme?

In reflexive thematic analysis, usually not as numbers. Describe spread in words, such as "most" or "a few", and keep the exact counts in your audit. Interviews wander, so a participant who never raised a point hasn't necessarily disagreed with it. Other approaches may report counts: APA's standards say findings may or may not include quantified information6, depending on the approach.

Can the results and discussion be combined?

Yes, depending on your approach. APA's reporting standards say findings and discussion may be combined6 where the approach to inquiry suits it. A combined section fits reflexive thematic analysis, whose final phase sets the analysis against existing literature. Check your department's or journal's rules first, and if you keep the two apart, make the discussion add something new.

Do I need a second coder or inter-rater reliability?

Only if your approach calls for one. Coding reliability thematic analysis uses independent coders and an agreement statistic such as Cohen's kappa. Reflexive thematic analysis doesn't. Braun and Clarke argue an agreement score shows two researchers have been trained to code data in the same way1, not that the coding is accurate. Talking your codes through with a supervisor still helps.

How do I write up a thematic analysis with River?

Attach your coded extracts with participant IDs in the box at the top of this page, add your research question, and pick your approach if you know it. River tests every candidate theme first. Then it writes the results section, a methods paragraph and an audit sheet into your free River workspace, where you can edit and share them or argue with any verdict.

Can River code my interview transcripts for me?

Only as a first draft. River expects coded data, because themes should rest on your own codes. If you send raw transcripts, it says so, drafts a first-pass code list with example extracts for you to review, and stops there. Revise the codes, code your data, then send the coded extracts back for the theme work.

Is the thematic analysis write-up tool free?

Yes, it is free to start. Your results section and audit sheet open in a River workspace, where you can edit them, share them with your supervisor or co-authors, or ask River to change them. Paid plans add more AI use and access to the most advanced models.

Sources

  1. thematicanalysis.net. “Got questions about Thematic Analysis? We have prepared some answers to common ones.” thematicanalysis.net (opens in a new tab)

  2. Palliative Medicine. “Supporting best practice in reflexive thematic analysis reporting in Palliative Medicine: A review of published research and introduction to the Reflexive Thematic Analysis Reporting Guidelines (RTARG).” pmc.ncbi.nlm.nih.gov (opens in a new tab)

  3. thematicanalysis.net. “Doing Reflexive TA.” thematicanalysis.net (opens in a new tab)

  4. Qualitative Research in Psychology. “Using thematic analysis in psychology.” educationaldevelopment.uams.edu (opens in a new tab)

  5. BMC Medical Research Methodology. “Using the framework method for the analysis of qualitative data in multi-disciplinary health research.” pmc.ncbi.nlm.nih.gov (opens in a new tab)

  6. APA Style. “JARS–Qual Table 1: Information Recommended for Inclusion in Manuscripts That Report Primary Qualitative Research.” apastyle.apa.org (opens in a new tab)

  7. EQUATOR Network. “Consolidated criteria for reporting qualitative research (COREQ): a 32-item checklist for interviews and focus groups.” equator-network.org (opens in a new tab)

Built by

Chandler Supple

Co-founder & CEO, River

Chandler has spent the last six years working in AI, building tools for millions of users and Fortune 100 companies. In 2025, he co-founded River to build a new kind of operating system for AI agents.

Reviewed by

Brian Joseff, Co-founder, River