Projects
Organize your research into Projects - rich containers that capture context, hypotheses, and findings.
What are Projects?
Projects are research containers that go beyond simple collections. They let you:
- Group related Query Cards together
- Document your research hypothesis
- Add notes and observations
- Link external resources (papers, pathways)
- Collaborate with team members
Projects require a free BioQuery account. Sign up at bioquery.io/signup.
Creating a Project
From Scratch
- Go to Projects in the navigation
- Click New Project
- Enter a name and optional description
- Add your hypothesis (optional but recommended)
From Query Results
After running a query:
- Click Save to Project on the Query Card
- Choose an existing project or create a new one
- Optionally mark as a key finding
From an Exploration
If you’ve been running queries in an Exploration session:
- Click Save as Project on the exploration page
- All queries from the session are converted to project cards
Project Components
Cards
Query Cards saved to your project. Each card includes:
- Original query and results
- Position (drag to reorder)
- Section assignment (e.g., “Expression Analysis”, “Survival”)
- Key finding flag
- Personal notes
Hypothesis
Document your research hypothesis at the project level. This appears prominently and helps frame your investigation.
Example:
DDR1 overexpression in papillary RCC may serve as a prognostic biomarker and therapeutic target.
Notes
Add timestamped notes to document:
- Observations from your analysis
- Questions to explore
- Decisions made
- Meeting notes
Note types: note, observation, question, decision
External Links
Link related resources:
| Link Type | Use Case |
|---|---|
paper | PubMed, DOI links to relevant literature |
pathway | KEGG, Reactome pathway links |
resource | GeneCards, UniProt, other databases |
other | Any other relevant URL |
Collaboration
Sharing Projects
Projects can be shared with collaborators:
- Go to your project
- Click Invite Collaborators
- Enter email addresses
- Choose their role
Roles
| Role | Can View | Can Edit | Can Delete | Can Invite |
|---|---|---|---|---|
| Owner | Yes | Yes | Yes | Yes |
| Editor | Yes | Yes | No | No |
| Viewer | Yes | No | No | No |
Organization members can be added as collaborators automatically if you’re on a team plan.
Project Visibility
| Visibility | Who Can See |
|---|---|
| Private | Only you and invited collaborators |
| Organization | All members of your organization |
| Public | Anyone (via published Study) |
To share a project publicly, publish it as a Study.
Best Practices
Organizing by Investigation
Create projects around research questions, not just genes:
Good: “DDR1 as Therapeutic Target in RCC” Less Good: “DDR1 Queries”
Using Sections
Group cards into logical sections:
- Background - Initial expression/mutation checks
- Mechanism - Pathway and correlation analyses
- Clinical - Survival and subtype analyses
- Validation - Cross-dataset confirmation
Documenting as You Go
Add notes while your reasoning is fresh:
- Why did you run this query?
- What did you expect vs. find?
- What follow-up does this suggest?
Converting to Study
Ready to share your findings? Projects can be published as Studies:
- Open your project
- Click Publish as Study
- Add title, summary, and key findings
- Choose visibility
- Share with the community
See Publishing Studies for details.