# Configure your Knowledge Graph Schema

The foundry is where you customize and manage your knowledge graph schema. The foundry can be accessed using the top application toolbar. 

## Overview

The **overview** is where you will see live metrics from your knowledge graph and a diagram of your graph schema. 

<figure><img src="https://1288106818-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F58V5gIKqqiaGKIL0OodX%2Fuploads%2FsnorcQIsr0Wd0gwzzh4d%2FScreenshot%202025-08-27%20at%2012.02.57%20PM.png?alt=media&#x26;token=fc75c3e6-8269-4d02-ba54-38a685613b76" alt=""><figcaption></figcaption></figure>

A quick action panel can be accessed on the right to manage your graph schema and data.&#x20;

## External Data Packages

\
By default the knowledge graph is completely blank. To quickly get started you can load in an external  data package. An external data pack is a set of standardized concepts, relationships and/ or objects preconfigured by the BioBox team.  This data is derived from industry standard knowledge bases and consortiums such as OpenTargets, Reactome, UBERONon and more. Each data pack is versioned, [accompanied by documentation](https://docs.biobox.io/guide/data-packages) and updated on a monthly basis.&#x20;

To browse the available data packages, select the "External data package" tab. Here you will see a list of all preconfigured data packages.

<figure><img src="https://1288106818-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F58V5gIKqqiaGKIL0OodX%2Fuploads%2FpZu1afZzjr9cSBCxlSdo%2FScreenshot%202025-08-27%20at%203.45.22%20PM.png?alt=media&#x26;token=4f6cc3b6-21e4-4558-888c-af95c15b657c" alt=""><figcaption></figcaption></figure>

#### Importing Data Packs

To import a package, select the import button in the top right hand corner of the card. When you import a data package, all of the concepts and relationships listed in the preview card will automatically be added to your knowledge graph schema.&#x20;

#### Data Pack Dependencies&#x20;

Some data packages have dependencies for concepts such as Genes and Diseases. This would require those concepts to be available in your knowledge graph prior to the import of the data package. When you hover over the import button you will be notified of any dependencies that need to be imported first. &#x20;

## Concepts

The **concepts** tab displays all of the concepts within your graph and their hierarchy that were created by you or imported through a data pack. Think of concepts as overarching categories such as Drugs, Diseases and Pathways.&#x20;

Selecting a concept will display all of the information and data objects associated with the concept.

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F58V5gIKqqiaGKIL0OodX%2Fuploads%2F8kaGiB3mYbZgZQyW7Kmx%2FConceptSelection.mp4?alt=media&token=ca2facfb-2fad-4c3c-ab56-302eddd24ae8>" %}

#### Creating New Concepts

Select "Create New Concept" provide a name and a description. If the concept is a subclass of another concept you can specify its parent concept.&#x20;

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F58V5gIKqqiaGKIL0OodX%2Fuploads%2FRTsbZUTqxp3KVv4Tbo6m%2FCreatingConcepts.mp4?alt=media&token=8cc99a2a-2c52-4add-9935-3b8a0f87e00c>" %}

**Editing Concepts**

To edit the name and description of the concept select the edit icon next to each

To update the relationships and data properties associated with a concept select "view in database" and this will open the administrative panel.&#x20;

#### Deleting Concepts - Deletion Impact Analysis

To delete a concept select the trash icon located in the top right hand corner of the concept. This will open an impact analysis that will show you all of the downstream impacts that will occur if you delete the concept.&#x20;

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F58V5gIKqqiaGKIL0OodX%2Fuploads%2Fs8seRTRQ5vmCCGi2vzfu%2FDeleteImpact.mp4?alt=media&token=6bb34d3b-65c5-47e4-bcdc-d6cd13b3da6b>" %}

## Properties&#x20;

The **properties** tab displays all of the data properties within your knowledge graph.&#x20;

<figure><img src="https://1288106818-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F58V5gIKqqiaGKIL0OodX%2Fuploads%2FJjFOgeL2kexsynWxivHK%2FScreenshot%202025-08-27%20at%203.18.23%20PM.png?alt=media&#x26;token=15182766-e187-4aa3-b144-fe9876e720d7" alt=""><figcaption></figcaption></figure>

## Relationships

The **relationships** tab displays all of the relationships within your graph that were created in your organization or were imported though a data pack.&#x20;

<figure><img src="https://1288106818-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F58V5gIKqqiaGKIL0OodX%2Fuploads%2FaW4FiFsEl7fl5EIU0sUN%2FScreenshot%202025-08-27%20at%203.20.18%20PM.png?alt=media&#x26;token=0505da7e-c69f-4988-b013-6f38fdf7bc38" alt=""><figcaption></figcaption></figure>

#### Creating New Relationships&#x20;

Select "Create Relationship" and specify the name, description domain (concepts this relationship points from) and range (concepts this relationship points to).

<figure><img src="https://1288106818-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F58V5gIKqqiaGKIL0OodX%2Fuploads%2Fv6kFN3uOJYgXdDuCVEIf%2FScreenshot%202025-08-27%20at%203.28.30%20PM.png?alt=media&#x26;token=e6fd492a-683e-4c2c-bf14-50ca285da121" alt=""><figcaption></figcaption></figure>

#### Editing  Relationships

Select "Edit Properties" and you will be able to add data properties to the relationship.&#x20;

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F58V5gIKqqiaGKIL0OodX%2Fuploads%2FQwIpYMYBDHwthFc5Hoc6%2FEditing%20Relationships.mp4?alt=media&token=07ac33c2-a58f-4843-a513-c25c5c025a48>" %}

#### Deleting Relationships - Delete Impact Analysis

To delete a relationship select the trash icon located in the top right hand corner. This will open the delete impact analysis, showing you the downstream impacts that will occur when the relationship is deleted. This will remove the relationship but will preserve the concepts that the relationship points to and from.

<figure><img src="https://1288106818-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F58V5gIKqqiaGKIL0OodX%2Fuploads%2FRyONyFY8y0tzu0CyMAiR%2FScreenshot%202025-08-27%20at%203.43.49%20PM.png?alt=media&#x26;token=c02001fc-b897-4838-b867-93f3347de43c" alt=""><figcaption></figcaption></figure>

<br>

### Data Upload

The **Data Upload** tab is where you can upload your internal data formatted as a data package. A detailed explanation [can be found here](https://docs.biobox.io/guide/how-to/configure-your-knowledge-graph-schema/upload-internal-data). <br>

{% hint style="info" %}
When uploading your data, the concepts and relationships that the data relates to must be created first. Please follow the instructions in this article to set up your graph schema prior to uploading proprietary data.&#x20;
{% endhint %}

***