HelpGathering Data › 23andMe

Gathering from 23andMe

Overview

23andMe data is gathered using a browser-based approach with AJAX interception. You log in to 23andMe through an embedded browser in the Client, and match data is captured automatically as the Client intercepts page responses. Additional data types (ICW, chromosome segments, haplogroups) are gathered via automated browser navigation after the initial login.

Available Data

Data Type Available Notes
MatchesYesCaptured automatically during browsing
ICW (In Common With)YesGathered via automated navigation (default: On)
Chromosome SegmentsYes*Requires a 23andMe+ subscription. Toggle available (default: Off).
HaplogroupsYesMaternal and paternal haplogroups (default: On)
Ancestry CompositionYesEthnicity/ancestry estimates (default: Off)
Family TreeNoToggle exists but 23andMe provides limited tree data
TriangulationNoToggle exists but currently hidden in the UI

Getting Started

  1. Navigate to Gather > 23andMe
  2. Click Web Login to open the 23andMe login page in the embedded browser
  3. Enter your 23andMe credentials (your email address and password)
  4. Once logged in, select your profile from the dropdown
  5. Configure your gather options (see below)
  6. Click Gather to begin data collection
  7. The Client navigates 23andMe pages and captures data from AJAX responses

23andMe may present a CloudFlare challenge during login. If you see a verification page, complete it in the browser and the Client will continue automatically.

Gather Options

Profile Selection

If you have access to multiple 23andMe profiles (e.g., family members who have shared access), select which profile to gather from using the dropdown.

ICW (In Common With)

Default: On. Gathers shared match (In Common With) data. This data is essential for clustering tools (CLM, Shared Clustering, Warthen Interactive Cluster). Has a dedicated Clear button to remove previously gathered ICW data.

Chromosome

Default: Off. Gathers chromosome segment data showing where you share DNA with each match. This data is used by CMA and the chromosome browser in the Warthen Interactive Cluster. Has a dedicated Clear button.

Requires a 23andMe+ subscription. 23andMe only exposes chromosome segment data to accounts with an active 23andMe+ Premium membership. Free 23andMe accounts cannot access this data, so enabling the Chromosome toggle on a free account will not return segment data.

Chromosome gathering adds significant time to the gather process. Enable it when you specifically need segment data for CMA or chromosome mapping.

Haplogroup

Default: On. Gathers maternal (mtDNA) and paternal (Y-DNA) haplogroup information.

Ancestry Composition

Default: Off. Gathers ethnicity and ancestry composition estimates.

Family Tree

Default: Off. 23andMe provides limited family tree data compared to other services.

cM Range

Set the minimum and maximum shared centimorgans to filter which matches are gathered. Only matches within this range will be collected.

Session Management

23andMe sessions can expire during long gather operations. The Client handles session expiration and re-authentication automatically when possible. If you are logged out, you may need to click Web Login again to resume.

Use Web Logout to explicitly end your 23andMe session when done gathering.

Additional Features

  • Run Report — Generates CSV files from the data already in your database (see Reports & CSV Files below)
  • Auto-Report — Toggle to run the report automatically as soon as a gather finishes, so the CSV files are created without a separate click
  • Multiple progress bars — Separate progress indicators for main gather, chromosome, and ICW
  • Clear buttons — Remove specific data types (Chromosome, ICW) before re-gathering
  • GDAT ID — Field for Genealogical DNA Analysis Tool (GDAT) integration

Reports & CSV Files

Gathering saves your data into the local database (the .db file in your database folder). It does not create CSV files on its own. CSV files are produced by the report step, which reads the data already in your database and writes it out in the universal CSV format used by other genealogy tools.

There are two ways to produce the CSV files:

  • Run Report — Click this button on the 23andMe gather page at any time to generate fresh CSV files from your current database contents. This only takes a few seconds and does not re-gather anything, so you can use it after a gather has finished without repeating the long collection process.
  • Auto-Report — Turn on this toggle before you gather and the report runs automatically the moment the gather completes.

If you gathered without Auto-Report turned on and don't see any CSV files yet, your data is still safe in the database — just click Run Report to create the CSVs. There is no need to gather again.

Output Files

The CSV files are saved directly in your database folder, alongside the .db file — the same folder the Open Folder button on the home page opens. You do not need to look inside the BrowserData subfolders; those hold the embedded browser's session cache, not your gathered data.

The exported CSV files are compatible with other genealogy tools, including DNAPainter, the Genealogical DNA Analysis Tool (GDAT), RootsFinder DNATools, and spreadsheet programs such as Excel and Google Sheets.