How to reset your access token?
To reset your access token, run the following commands in order:
txg auth reset
: to delete any previously saved authentication tokens.txg auth setup
: to set up a new authentication token interactively. Find your access token on your Account Security page. Do not share this access token or use this on a public computer.txg auth verify
: to verify that the stored access token is valid and that the 10x Genomics Cloud Analysis service can be successfully reached.
Details are available on the 10x Genomics Cloud CLI page under "Authentication".
What collaboration features are available? Can I share my projects or data with collaborators?
Cloud Analysis allows you to transfer projects from one user account to another user account. In the Project Settings page of each project, you will find a place to enter the email address of the person you'd like to transfer the project to.
We expect to add more collaboration features over time, including the ability to invite multiple users to the same project.
Have ideas about collaboration features that you'd like to see? Give feedback to the team.
Is there a limit on how many project transfers can be done?
Yes, each project can be transferred a maximum of three times. After three successful transfers, the project transfer functionality will be disabled for the selected project. Multiple transfers between two users will count as individual events.
How does project transfer impact free usage limits?
Each time a project is successfully transferred to another Cloud Analysis user, the free usage limits are reset. The recipient of the project will receive 90 days of free storage for each file within the project starting from the date that the transfer completed. The recipient will also have the ability to run new analysis pipelines and download files as though this is a new project.
What products and analysis pipelines are supported?
For the latest information on supported products and analysis pipelines available on Cloud Analysis, visit the Supported Products page.
What references are available?
Currently, Cloud Analysis provides the following references compatible with Cell Ranger Single Cell Gene Expression analysis:
- Human (GRCh38) 2020-A
- Human (GRCh38) v3.0.0
- Human (hg19) v3.0.0
- Mouse (mm10) 2020-A
- Mouse (mm10) v3.0.0
- Human and mouse (GRCh38 and mm10) 2020-A
- Human and mouse (GRCh38 and mm10) v3.1.0
- Human and mouse (hg19 & mm10) v3.0.0
For Cell Ranger V(D)J analysis, Cloud Analysis provides:
- Human (GRCh38) - v5.0.0
- Human (GRCh38) - v4.0.0
- Human (GRCh38) - v3.1.0
- Mouse (GRCm38) - v5.0.0
- Mouse (GRCm38) - v4.0.0
- Mouse (GRCm38) - v3.1.0
For Cell Ranger ARC analysis, Cloud Analysis provides:
- Human (GRCh38) - v2.0.0
- Mouse (mm10) - v2.0.0
For Space Ranger analysis (Visium HD), Cloud Analysis provides:
- Human (GRCh38) 2020-A
- Mouse (mm10) 2020-A
For more information on these references, including build steps, visit the Cell Ranger references for Single Cell Gene Expression and Single Cell Immune Profiling data, the Cell Ranger ARC references for Single Cell Multiome data, or the Space Ranger references for Visium HD.
Can I use a custom reference?
Yes, custom references are supported in Cloud Analysis, with the following caveats.
For Cell Ranger:
- Custom references must be generated with
cellranger mkref
v3.1.0 or higher. Thespaceranger mkref
references cannot be used incellranger count
orcellranger multi
- The pipeline version that is run in Cloud Analysis must be the same or more recent than the version of
mkref
used to generate the reference
For Cell Ranger ARC:
- Custom references must be generated with
cellranger-arc mkref
v2.0.0 or higher - Only references generated with
cellranger-arc mkref
can be used
For Space Ranger:
- Custom references must be generated with
spaceranger mkref
v3.0.1 or later
Can I upload a public 10x Genomics dataset from the Sequence Read Archive (SRA)?
In many cases, 10x Genomics datasets that are available at the Sequence Read Archive are compatible with Cloud Analysis, but you must first pre-process the files. For details on the types of datasets that are available and how to prepare your data, please view our Knowledge Base guide.
What are cell annotations and how can I obtain them?
Cell annotations refer to the process of categorizing and assigning cell types to individual cells based on their gene expression profiles. These annotations are needed for understanding the cellular composition and diversity within a sample.
Cell Ranger introduces a new pipeline for cell type annotation, which can be applied to standard Cell Ranger outputs to generate cell type labels. This method assigns cell types by comparing each cell's gene expression profile to annotated reference datasets, rather than relying on known marker genes or tissue-specific references. It provides a starting point for annotating your samples. For more refined annotations, you can investigate specific marker genes or try reclustering in Loupe.
Specifically, each cell barcode's gene expression data is compared to the Chan Zuckerberg CELL by GENE (CZ CELLxGENE) census, identifying the most similar cell types. A consensus label is then assigned to each barcode, with the results summarized in the web_summary.html
. These labels can be viewed in Loupe Browser or accessed via the cell_types.csv
output file.
Run the pipeline or learn more about the underlying algorithms and models.
What does it mean for annotate to be a beta feature?
Cell annotation is a complex challenge that lacks a universal solution. While we have rigorously benchmarked our method across various tissue types, the diversity of tissues and cell states (e.g., cancerous, diseased, juvenile, embryonic) far exceeds what we can comprehensively test in-house. As a result, the annotation pipeline has not undergone the same level of testing as our other algorithms. We are releasing the annotate pipeline as a beta feature with the intent to collect feedback.
We encourage customers to use this tool as a starting point for identifying cell types of interest, aiming to streamline a process that is typically manual and time-consuming. This beta release helps us gather meaningful feedback from the community so that we can continue to improve the models. Please note that annotate may remain in beta, depending on the scope and nature of feedback we receive.
Which species are compatible with the cell annotation pipeline?
The cell annotation pipeline currently supports annotations for human samples only.
What are the options for uploading data to 10x Genomics Cloud Analysis?
Currently we support two options for uploading your data. You can either use the Web Uploader to quickly drag and drop files in your browser, or the Cloud CLI to upload files from the command line (which may be preferable for large numbers of files).
Can I download my data?
Yes, you can download your custom references, images, FASTQ files, and analysis output files via curl
and wget
commands. Additionally, you may choose to download analysis output files through the browser. We recommend downloading all large files via curl
or wget
.
What is 10x Genomics doing to secure my data?
We care about securing your data and protecting your user account. Here are some of the protocols and practices we have in place:
- Data is encrypted in transit and at rest using industry-standard protocols and ciphers.
- Multi-factor authentication is available to all of our users, and can be set up in the Account Settings page.
- Our platform undergoes routine independent assessments and penetration tests, covering functionality, business logic, common vulnerabilities, and reviews of security controls and requirements, including the OWASP Top 10 and ASVS.
- We utilize automated static and dynamic analysis tools to scan for vulnerabilities and potential security issues.
- Access to the platform and infrastructure is internally restricted and follows the principle of least privilege.
- A Security Operations Center team provides dedicated 24/7 monitoring of security-related events.
Learn more about how 10x Genomics secures customer data and user accounts on the cloud.
Where are the 10x Genomics Cloud servers located?
Servers and data storage buckets are hosted by Amazon Web Services and are located in the United States.
Do you have any guidance on how to cite datasets that were generated in Cloud Analysis?
To cite datasets that were generated in 10x Genomics Cloud Analysis, we recommend that you use the following format:
- 10x Genomics Software Name and Version x.y.z using 10x Genomics Cloud Analysis
For example:
- 10x Genomics Cell Ranger 5.0.1 using 10x Genomics Cloud Analysis
- 10x Genomics Cell Ranger 4.0.0 using 10x Genomics Cloud Analysis
For more information about citation of 10x Genomics Software and products, please visit our citations page .
Is Cloud Analysis available in my region?
- Cloud Analysis is available globally except for Cuba, Iran, North Korea, Syria, Russia, Belarus, China, Hong Kong, Venezuela, and Ukraine. Using the Cloud Analysis services in excluded territories, or by persons that are subject to debarment or any list-based designations under U.S. or other applicable export controls laws and regulations, is a violation of the Cloud Analysis Service Terms and the applicable account will be terminated.
- While Cloud Analysis is currently unavailable in Ukraine, we expect that the services will be enabled in the future, with the exclusion of the regions of Crimea, Donetsk Regions of Crimea, and the city of Luhansk. You may inquire about access to Cloud Analysis in your region by reaching out to [email protected].
- Paid services beyond the free usage limits are available only in the United States and Canada. See Usage outside the U.S. and Canada on our Billing page for more information.
Which web browsers can I use to access 10x Genomics Cloud Analysis?
We recommend that you access Cloud Analysis through a recent version of a browser from our supported list, seen below.
Supported desktop browsers:
Supported tablet browsers:
What systems can I upload custom reference and FASTQ files from?
Currently, we support uploading custom references and FASTQ files from Linux, macOS, and Windows 10.
Recommended Operating Systems:
- Ubuntu Linux 20.04
- macOS 10.15 and above
- Windows 10 build 17063 and above
Learn more about uploading files using the 10x Genomics Cloud CLI here .