10x Genomics Support/In Situ Gene Expression/Documentation/Panel Design/

Xenium Panel Designer Frequently Asked Questions

  • Questions about design IDs
  • Getting started with custom designs
  • Reference datasets
  • Advanced and species standalone custom requests

Questions about design IDs

1. What is a design ID?

A design ID (also referred to as a CDP #) is a unique 6-character identifier for each Xenium custom panel design. 10x Genomics generates the design ID and it will be printed on the consumable packaging for your reagents. Additionally, the design ID is in the name of a JSON file that must be loaded onto your instrument when setting up the Xenium Analyzer instrument run that utilizes your custom panel.

2. I do not have a design ID. Do I need one to design a custom panel and how can I generate one?

  • If you are generating a human or mouse panel that targets standard genes from the human or mouse transcriptomes, you do not need a design ID to create the custom panel request. At the end of the panel design workflow, a design ID will automatically be generated. Share this design ID with your 10x Genomics sales representative to proceed with ordering your custom panel.
  • If you are requesting a species standalone custom panel or if you are planning to include advanced custom targets, you will need a design ID prior to entering your design request into the Xenium Panel Designer. Contact your 10x Genomics sales representative to discuss your experimental design and request a design ID for your custom panel.

3. I began my panel design request without a design ID, and now I want to provide a design ID. Is this supported?

No, currently you must choose whether or not you will provide a preexisting design ID at the beginning of the panel design workflow. If you begin the panel design process without a design ID and later decide to provide an existing design ID, start a new request for that existing design ID and copy over your gene list and references from the initial design.

Getting started with custom designs

1. What are the requirements for creating a Xenium custom panel?

You will need the following for all Xenium custom panels:

  • A gene list that contains the genes you wish to target in your Xenium experiment.
  • An annotated single cell reference dataset in the 10x Genomics MEX or HDF5 file formats.
    • The panel design tool provides a selection of curated references from CELLxGENE and GEO that can be used if they work with your experimental model.
    • The references should closely resemble the tissue and condition of the samples you plan to use in your Xenium experiment.
    • The references can be data from either 10x Chromium (Single Cell 3' Gene Expression or Single Cell Gene Expression Flex) or Visium (with reference-free deconvolution) platforms.
  • Learn more here.

For advanced custom targets, you will also need:

2. What happens when I reduce the number of probes per target?

We observe a roughly linear relationship between the number of probes for a target and the relative sensitivity of detection. This relationship is only true on the aggregate; individual probe behaviors will deviate depending on probe binding dynamics.

3. I am comparing data across multiple Xenium panels which have different probe set counts for overlapping genes. Do you have recommendations for how I should compare data across panels?

If the goal is to generate data for a specific gene that is directly comparable between different panels, consider whether the same probe sets are being used across panels for that gene. Due to our in silico screen for probe-probe interactions, these are not guaranteed to be the same across any two panels. However, this information can be found by checking the panel BED files, which are available as outputs of the custom panel design process and on the support site for pre-designed panels.

We have observed that sensitivity scales linearly, on average, with the number of probe sets in the range of 1-8 probe sets. If the panels have a different number of probe sets for the gene of interest, you can apply a gene-specific scaling factor to compensate for the sensitivity difference.

4. How do I check if there is a significant overlap between my genes of interest for a custom panel and Xenium pre-designed panels?

The Xenium Panel Selector allows you to input your genes of interest and to determine how many of the genes are in each of the available pre-designed panels. Learn more here.

Additionally, when you are requesting your custom panel in the Xenium Panel Designer app, we provide a warning on the design summary file if > 50% of your genes of interest are already included in any of our pre-designed panels.

5. Can a custom add-on panel designed for a particular Xenium pre-designed panel be used with other Xenium pre-designed panel products?

No, each custom add-on panel is designed for use with a specific pre-designed panel.

The "Panel Information" section of the finalized panel view in the Xenium Panel Designer app shows the pre-designed panel your add-on panel was designed for. For example, the screenshot below shows an add-on panel designed for the pre-designed Human Brain Gene Expression Panel.


6. Can I change or edit my design after finalizing the panel?

No, you cannot change or edit the design after finalizing the panel design request. If you want to request a similar panel to the one you have finalized, you can download the gene list CSV file from your finalized panel and use it as a starting point for the new request.

Reference datasets

1. Why do I need a single cell reference dataset?

The single cell reference datasets are used to determine how much of the detection budget the panel is expected to use in the sample. This helps guide the selection of genes that can or cannot be successfully assayed, and provides a basis for deciding which genes require probe set coverage decreases. It allows the design tool to place coexpressed genes on optically distant barcodes to make the most efficient use of the optical space.

It is particularly important to find the best possible single cell dataset that you can (i.e., most similar to the sample you plan to use in your experiment) when working in diseased tissue. Learn more here.

2. What are the requirements for uploading my own single cell reference to the Xenium Panel Designer?

Your single cell reference must be unnormalized whole transcriptome feature-barcode matrices with cell type annotations for each matrix. The matrix and annotations should be bundled as a .zip, .tar, or .tar.gz file (one matrix + one annotation file per bundle). The accepted feature-barcode matrix formats are: 10x HDF5 or MEX. The 10x CLOUPE file format is also supported. Learn more about single cell references here and reference format conversion here.

The total size of your uploaded reference files must be less than 500 MB per design. The panel designer app computes a pseudobulk matrix from your reference. As long as all cell types of interest are well-represented, the end result of matrices with 50,000, 200,000, or 1 million cells will be very similar. If your references are collectively more than 500 MB, we recommend subsampling the abundant cell types in the file (avoid subsampling rare cell types).

3. What if I do not have a single cell reference?

We recommend that you have a closely matched single cell RNA-seq reference to accurately determine how much of the detection budget your panel is expected to use. It is particularly important to find a close match when working with diseased tissue types.

If you do not have an annotated single cell RNA-seq, you can use publicly available data from sources such as CELLxGENE. The Xenium Panel Designer provides a variety of curated reference datasets for both human and mouse tissues and a variety of conditions:

SpeciesTissueCondition
HumanBrainAlzheimer's
HumanBrainGlioblastoma
HumanBrainNon-diseased
HumanBreastCancer (ER+, HER2+, or triple-negative)
HumanBreastNon-diseased
HumanColonColorectal cancer
HumanColonNon-diseased
HumanHeartNon-diseased
HumanKidneyClear cell carcinoma
HumanKidneyNon-diseased
HumanLiverHepatocellular carcinoma
HumanLiverNon-diseased
HumanLiverNon-diseased
HumanLungNon-diseased
HumanLungNon-small cell lung cancer (NSCLC)
HumanLungSARS-CoV-2 infection
HumanLungSmall cell lung carcinoma
HumanLymph NodeNon-diseased
HumanMultipleNon-diseased
HumanOvaryOvarian cancer
HumanPancreasDuctal adenocarcinoma
HumanPancreasNon-diseased
HumanRetinaNon-diseased
HumanSkinNon-diseased
HumanSkinNon-diseased
MouseBrainNon-diseased
MouseHeartNon-diseased
MouseKidneyNon-diseased
MouseLungNon-diseased
MouseMultipleNon-diseased
MouseRetinaNon-diseased

This table was last updated on January 25, 2023.

Advanced and species standalone custom requests

1. What is advanced custom panel design?

Standard custom panels target well-annotated genes in the human and mouse 2020-A reference transcriptomes.

Advanced custom panel designs target sequences that we do not have existing probe designs for. Potential advanced custom applications include isoforms, gene fusions, viral or bacterial sequences, protein tags, fluorescent reporters, and transgenes.

More information is available in the Species Standalone Custom and Advanced Custom Panel Design for Xenium In Situ Technical Note.

2. Can I contact 10x support if I have questions about requesting an advanced custom panel design (e.g., feasibility of experimental design, assay sensitivity or specificity for a target gene, multi-species, etc.)?

Submit your questions to [email protected] if you have technical questions prior to starting an advanced custom panel design. It is important to carefully consider the feasibility and experimental design before starting this design process.

3. Who do I contact if I have questions about purchasing an advanced custom panel before starting the panel design process?

Contact your local sales representative or distributor for any questions about advanced panel designs. If you do not know your local sales representative, contact [email protected].

4. What is an advanced panel upgrade and how do I pay for it?

Advanced panel upgrade is a product upgrade which enables you to generate panels for applications not possible with standard gene expression panels. The Advanced Custom and species custom designs are complex and require bespoke design optimization for each panel request. You can upgrade your custom panel to an advanced panel by purchasing an Advanced Panel Upgrade.

You need to have a PO for a custom panel and an Advanced Panel Upgrade associated with the panel design ID in order to submit a request for an Advanced custom panel on the Xenium Panel Designer. We will invoice you for both part numbers after the panel design has been finalized.

5. Why do I need an advanced panel upgrade?

Each advanced custom or species standalone custom request is built by the 10x Genomics Applied Bioinformatics team in collaboration with customers. The advanced panel upgrade is only required for designs led by our Applied Bioinformatics team.

6. I plan to request a human or mouse panel and to add probes for bacterial or viral genes. Should I select "human", "mouse", or "other" for my organism?

We would consider "human" or "mouse" to be the organism in this case, with advanced custom targets added.

7. How do I specify sequences for advanced custom design?

There are a few common target design modes: isoforms, single nucleotide variants, exogenous genes, T cell receptors, and barcode detection. Guidance submitting information for these targets is provided in the Workflow 2: Request species standalone or advanced custom panels documentation. The files associated with these targets can be sent to your 10x bioinformatics representative.

To specify RNA binding sequences for advanced custom probe sequences, create a CSV file formatted as specified in the Species Standalone Custom and Advanced Custom Panel Design for Xenium In Situ Technical Note. This CSV file can be uploaded to the Xenium Panel Designer or you can work with your 10x bioinformatics representative to generate it.

Document Type
Panel Information

Last Modified
March 13, 2024