Annotations contain important information about files, cases, or metadata nodes that may be of use to data downloaders when analyzing GDC data. They should be reviewed prior to running an analysis. An annotation may include key comments about why particular patients, samples, or files are absent from the GDC or why they may exhibit critical differences from others. Annotations include information that cannot be submitted to the GDC through other existing nodes or properties.

Annotations are automatically downloaded in TSV format with impacted files when using the Data Transfer Tool. They may also be searched via the API or on the annotations page of the GDC Data Portal. Instructions on accessing annotations in the GDC Data Portal are found in the GDC Data Portal User Guide.

For information on Annotation structure and content please review the GDC Data Dictionary

For information about TCGA conventions for annotations please see the TCGA Introduction to Annotations.

If a submitter would like to create an annotation, please contact the GDC Support Team (


  1. API User Guide
  2. GDC Data Portal
  3. GDC Data Portal User Guide
  4. GDC Data Dictionary
  5. TCGA Annotations
  • N/A

Categories: Data Type