HelpGathering Data › FTDNA

Gathering from Family Tree DNA

Overview

FTDNA data is gathered using a credential-based approach. You enter your FTDNA user ID and password in the Client, which communicates directly with FTDNA's API to download match data. This is typically faster than browser-based gathering.

FTDNA provides the broadest range of data types: matches, chromosome segments, ICW, and family trees.

Available Data

Data Type Available Notes
MatchesYesMatch name, shared cM, segments, relationship
Chromosome SegmentsYesShared DNA segments by chromosome (default: On)
ICW (In Common With)YesShared match relationships (default: On)
Family TreesYesMatch family tree data, including FTDNA-native trees and MyHeritage trees that the match has linked through FTDNA's MyHeritage integration (default: On)
EthnicityNoNot currently gathered
HaplogroupsNoNot currently gathered

Getting Started

  1. Navigate to Gather > Family Tree DNA
  2. Enter your FTDNA credentials or select saved credentials from the dropdown
  3. Click Login
  4. Select a DNA profile/kit from the profile dropdown
  5. Configure your gather options (see below)
  6. Click Gather to begin data collection

Your FTDNA user ID is typically a number (e.g., 123456 or B1234). It is not your email address. You can find it on your FTDNA account page.

Gather Options

Profile Selection

If you manage multiple FTDNA kits (e.g., as a Group Administrator), select which profile to gather from using the dropdown. The Client supports managing multiple saved credentials.

Chromosome

Default: On. Gathers chromosome segment data showing where you share DNA with each match. Has a dedicated Clear button to remove previously gathered chromosome data before re-gathering.

ICW (In Common With)

Default: On. Gathers shared match relationships. Essential for clustering tools. Has a dedicated Clear button.

Trees

Default: On. Gathers family tree data for matches that have linked trees. Has a dedicated Clear button.

This includes both FTDNA-native trees and MyHeritage trees that the match has linked to their FTDNA kit through FTDNA's MyHeritage integration. You don't need to run a separate MyHeritage gather to capture those linked trees — they come through with the FTDNA tree gather.

Match cM Range

Set the minimum and maximum shared centimorgans to filter which matches are gathered. The default minimum gathers matches sharing 6 or more cMs.

Start with a higher cM minimum (30+) for your first gather. FTDNA kits can have thousands of matches at low thresholds, and gathering all of them takes considerable time.

Chromo cM Minimum

Default: 6 cM. Sets the minimum segment size for chromosome data collection. Segments below this threshold are not gathered. Increase this value to filter out small, less reliable segments.

Credential Management

The Client supports saving multiple FTDNA credentials. This is useful if you manage kits for family members or as a Group Administrator. Select a saved credential from the dropdown, or enter new credentials to add them.

You can give each saved credential a friendly name — for example “Mom's kit” or “Dad — paternal line” — so you don't have to remember which numeric kit ID belongs to whom. If you leave the name field blank, the Client will fill it in with the kit's actual name from FTDNA the first time you log in with those credentials.

The "Remember Me" option stores your credentials securely so you don't need to re-enter them each session.

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 for matches, chromosome, ICW, and tree data
  • Clear buttons — Remove specific data types before re-gathering
  • GDAT ID — Field for Genealogical DNA Analysis Tool (GDAT) integration

FTDNA Browser Gather (Coming Soon)

A browser-based FTDNA gathering mode is in development as a Gold feature. This will use the same AJAX interception approach as A* and 23andMe, with added support for GAP (Group Administrator Projects) to manage multiple kits through a single session. This feature requires a Gold subscription.

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 FTDNA 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 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. The exported 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.