How to report an issue

Jason Cerrato
  • Updated

If something appears broken, slow, or just plain weird, we want to hear about it! Reporting issues allows us to identify necessary improvements and work toward building a more positive Terra experience. We want your important work to proceed with as few snags and hiccups as possible.

Reporting options There are a few different ways to report a problem you're having on Terra. The list below starts with the most recommended option.

Option 1. Post to general discussion in the Community Forum

In most cases, we recommend reporting your issue to our General Discussion board so other users with a similar issue can learn from the resolution. Posting on this board allows other users to help with your issue. That can decrease the wait time from report to resolution.

Option 2. Use the Contact Us form in Terra

If you feel uncomfortable sharing your issue with others, you can contact us directly in Terra by clicking the main navigation menu at the top left, clicking Support to expand, and then selecting Contact Us (screenshot below left).

A Contact Us window will pop up where you can let us know what's going on (screenshot below right).

Contact Us in the main menu

Screenshot of the Contact Us option found by expanding the 'Support' section from the main menu (three parralel lines at the top left of any page in Terra).

The Contact Us form

The contact us form, with a dropdown for the type of questions, fields for the subject and main email content, an option to add an attachment, your contact email, and whether you are a clinical user.

Option 3. Email support directly

You can email us by writing to

Guidelines for reporting an issue

1. Check to see if someone already reported this issue
You can look in our General Discussion board, or see if it has been posted to our Known Issues board. If the issue has been reported, adding your case to the existing thread lets us focus on the solution instead of on communicating with everyone individually. 

2. Share the workspace where you're seeing this issue
In most cases, it's helpful for us to have access to the workspace where the issue is occurring.

2.1. Click the three vertical dots action icon at the top left of the workspace dashboard and select Share from the menu.

Screenshot of the menu used to share a workspace. Open this menu by clicking on the three vertical dots at the top right of any page in the workspace.

2.2. In the form, toggle the Share with support option on.

Screenshot of the Share workspace form highlighting the toggle to share workspace with support

2.3. Click save.

3. If what you are doing worked before, and is now not working, please let us know when you last saw this working and when you noticed it stopped working.

4. If you get an error message, please provide the steps you took that led to the error and a screenshot of the error.

5. If you need help with a workflow issue, please provide the relevant submission and workflow IDs. You can find these by clicking on the submission in your workspace's Job History tab, which will open a page like the one below:

Screenshot of the Job History page for an example workflow submission. Orange boxes highlight the Workflow ID and the Submission ID, which are important to report to Terra Support if you're having trouble with a workflow.

6. If you need help with a Cloud Environment issue, please provide the following details in your report:

  • Terra account email address
  • Workspace Google Project ID (found on the workspace's dashboard)
  • Cluster ID (found under Details at
  • Screenshot of cloud environment configuration (found by clicking on the Environment Configuration cloud icon on the workspace's right-hand panel)
  • Link to workspace

We ask for your patience when waiting for a response. We help everyone as quickly as possible.

7. Be polite! Don't use sarcasm, be rude to other users or staff, and don't use strong language. See the Terra Community Guidelines for more guidelines.

Was this article helpful?

1 out of 1 found this helpful



Please sign in to leave a comment.