Skip to main content
All schema changes in Hub happen on branches, not on main. You create a branch, make your changes on the canvas, and open a proposal when you are ready for review. Main stays untouched until a proposal is approved and merged.

Walkthrough

Fork from Main

Click the branch dropdown in the top bar next to the graph name. Select Fork to create a new branch from main. Give the branch a name that reflects the feature or change you are making.
The branch captures the full schema state at the point you fork. Any changes you make are isolated to that branch.

Reset the Canvas (Optional)

Click Reset in the toolbar to clear the canvas layout if you want a focused view. This does not delete any schema data. Skip this step if you prefer to keep the existing layout.

Create a Field or Type

Click Create in the toolbar and select Create Type / Field. Hub opens the Create New modal, which has two tabs. Select New Fields to add fields to an existing type. Choose the parent type from the Select existing type dropdown, then use Add Field to define each field. See Design a Query Before the Fields Exist for a full walkthrough of the field creation controls. Select New Type to define a new type from scratch. Name the type, choose its kind, and add initial fields inline. Enable Create More to keep the modal open after each creation if you are adding several fields or types in sequence.

Assign to a Subgraph

Fields created at the supergraph level are unassigned until you place them in a subgraph. An unassigned indicator appears on the field row in place of the standard icon controls. Click the unassigned indicator to open the Assign to subgraph modal. Select an existing subgraph from the list to assign the field to it. If the field requires a new service, select Create new subgraph at the bottom of the list. Hub opens the Create New Subgraph modal where you enter a name. Hub then creates a new subgraph schema containing the field and any dependencies it needs.
If you are unsure which subgraph should own the field, open Governance in the top bar to check type and subgraph ownership, or use Threads to start a discussion with the relevant team.
New fields or types on an isolated branch, assigned to the correct subgraph. The unassigned indicator clears when every field is placed. Main is untouched.