KBase Documentation
  • KBase Documentation
  • KBase Terms & Conditions
  • Getting Started
    • Signing Up and Signing In
      • Step-by-Step Signup Guide
      • Authentication Update
    • Supported Browsers
    • Narrative Quick Start
    • Narrative Interface User Guide
      • Access the Narrative Interface
      • Tour the Narrative Interface
      • Narrative Navigator
      • Create a Narrative
      • Explore Data
      • Add Data to Your Narrative
      • Browse KBase Analysis Tools
      • Analyze Data Using KBase Apps
      • Job Browser
      • Revise Your Narrative
      • Format Markdown Cells
      • Share Narratives
      • Linking Static Narratives to ORCID
      • Access and Copy Narratives
      • Organizations
    • FAQs
  • Manage Your Account
    • Linking Accounts
    • Linking KBase to ORCiD
  • Working with Data
    • Data Upload and Download Guide
      • Data Types
      • Importing Data
        • Bulk Import Limitations
      • Assembly
      • Genome
      • FASTQ/SRA Reads
      • Flux Balance Analysis (FBA) Model
      • Media
      • Expression Matrix
      • Phenotype Set
      • Amplicon Matrix
      • Chemical Abundance Matrix
      • SampleSet
      • Compressed/Zipped Files
      • Bulk Import Specification
      • Downloading Data
    • Searching, Adding, and Uploading Data
    • Filtering, Managing, and Viewing Data
    • Linking Metadata
      • Ontologies and Validated Terms
    • Public Data in KBase
    • Transfer Data with Globus
  • Using Apps
    • Analysis Apps in KBase
      • Assembly & Annotation
      • Comparative Genomics
      • Metabolic Modeling
      • Metagenomics & Community Exploration
      • Data Matrices - Amplicon, Stats
      • Chemical Abundance
      • Expression & Transcriptomics
    • Apps in Beta
  • Running Common Workflows
    • Assembling & Annotating Microbial Genomes
      • FAQ: Assembly and Annotation
    • Comparative Genomics & Phylogenetic Analysis
      • FAQ: Comparative Genomics
    • Metagenomic & Community Analysis
      • FAQ: Metagenomics & Community Analysis
    • Transcriptomic Analysis
      • FAQ: RNA-seq Analysis
    • Constructing Metabolic Models
      • Constructing and Analyzing Metabolic Flux Models of Microbial Communities
      • FAQ: Metabolic Modeling
  • Community Developed Workflows and Tools
    • Functional Annotation
    • Functional and Taxonomic Profiling of MAGs
    • Taxonomy
    • Viral
    • Random Walk with Restart Toolkit
  • Troubleshooting
    • Problems with the User Interface
    • Help Board
    • How to Report Issues
    • Job Errors and Their Meanings
      • Common Job Errors
        • The Job Log
      • Import Job Errors
      • Assembly App Errors
      • Annotation App Errors
      • Functional Genomics App Errors
      • Modeling App Errors
  • Developing Apps
    • The KBase SDK
    • Create a KBase Developer Account
    • KBase GitHub Repository
  • External Links
    • KBase Narrative Interface
    • KBase web site
    • KBase App Catalog
  • kbase.us
Powered by GitBook
On this page
  • What is a KBase Org?
  • Creating an Organization
  • To create an Organization, you will need:
  • Editing an Organization
  • Joining an Organization
  • Viewing Narratives in an Org
  • Administering an Organization

Was this helpful?

  1. Getting Started
  2. Narrative Interface User Guide

Organizations

How to access, search, and create KBase Organizations for labs, collaborating researchers, courses, and more.

PreviousAccess and Copy NarrativesNextFAQs

Last updated 1 year ago

Was this helpful?

What is a KBase Org?

In science, people are members of labs, teams, groups, collaborations, and projects that work together with shared data and analyses. In KBase, organizations are a way for teams of scientists to share their data and associated analyses that are in the Narratives they create with each other as a group. Organization members can see information about the team and a list of the Narratives associated with the organization to which can request access. View-only access is granted upon request while all other access to the Narrative is granted by the Narrative owner. KBase users can be members of more than one organization and Narratives with the associated data might also be added to more than one organization.

Creating an Organization

On the Orgs page, click "Create Organization" button on the right side. This will open the Create Your Organization page. Input the information and Save.

To create an Organization, you will need:

  • Name ⏤ the displayed Organization Name

  • ID ⏤ the unique URL for the Organization; can only contain lower case letters (a-z), numeric digits (0-9) and the dash "-"

  • Logo URL (optional) ⏤ include the link to a publicly available image

  • Home Page URL (optional) ⏤ input your lab or group's website URL to link and share

  • Hidden? ⏤ check for the Organization to be Hidden - will be visible only for members of this organization or leave unchecked to remain Visible - will be visible to all KBase users.

  • Research Interests ⏤ list your Organization's research interests here

  • Description ⏤ provide a description of your Organization

Editing an Organization

There are options to edit and share an organization after it has been created.

Joining an Organization

  • If an invitation appears in your feeds, click on the ID of the organization. A window will pop up with options to Accept or Reject the invitation. Click on your preference.

  • Without invitation, search for the organization and click on its name. Click on the blue button (upper right) to ‘Join Organization’. You cancel this request if needed. A request to join will be sent to the owner and group administrators. An acceptance or rejection will be added to your Feeds. Note: Private organizations will not appear.

  • If you know the organization URL (starts with https://Narrative.kbase.us/#org/) go to the webpage and request membership.

Viewing Narratives in an Org

  • If you haven't opened the Narrative before, there will be a "Click for Access/View Access" button

    • Click the "Click for View Access" button

    • You will be able to open and view the Narrative when the "No Access" line disappears

    • To open a Narrative, click on the Narrative name

  • There are several icons that may appear in the Narrative cell:

Administering an Organization

  • Invite members by clicking the invite button on the right above the list of members.

    In the Search box ‘Select User to Invite’, type in the user’s name or KBase ID. A list of users will appear below the search box. Click on the user to invite and the name will appear on the right with more information that can be used to confirm it is the correct user. If correct, click on the blue ‘Send Invitation’ button.

  • On the right side of the organization page is a list of organization members. Above the list of members is a tab called ‘Requests’. There is an "Inbox" for a list of Users requesting to join and an "Outbox" of owner/administrator invitations for pending invitations for users to join that the owner or administrator made. Requests can be accepted or rejected by clicking the respective buttons. Invitations can be cancelled at any time, but will also disappear after a length of time.

  • Owners and administrators can can promote members to administrator. In the membership list, click on the ‘...’ to the right of the member’s name and click on ‘Promote to Admin’.

  • Members can be removed by click on the ‘...’ to the right of the member’s name in the membership list and click on ‘Remove Member’. The user is not notified that they have been removed.

  • There is no mechanism to delete an organization. You can un-associate all Narratives, remove all members and set the group to “Private.”

globe - Narrative is shared publicly with all KBase users

pencil - Narrative is shared with you with edit access

open lock - Narrative is shared with you with access to edit and share

closed lock - private

eye - View-Only access

crown - you are the owner

Add Narratives by either the "+ Add a Narrative" button or with an Org.

share Narratives
7 minute video tutorial on KBase Organizations
Access a Narrative by clicking the "Click for View Access" button to be able to view the Narrative.