#Hygraph Studio walkthrough
This page walks through the Hygraph Studio interface so you know where everything lives before you start building. If you want a step-by-step guide to creating a project and querying content, start with the Quickstart.
#Overview
When you log in to your Hygraph account, you land in the project directory. This is the account-level view, separate from any individual project. Here you can find the following tabs at the top:
- Projects
- Your apps
- Analytics
#Projects
Projects lists your active projects and any pending project invites. It also includes a Showcase project you can use to explore Hygraph features before building your own.
Projects
#Your apps
Your apps is where you create and manage custom apps you have built using the Hygraph App Framework. Apps you create here can be installed into projects and shared with other users.
Your apps
#Analytics
Analytics gives you a usage overview across all projects you have access to, scoped to the master environment. You can customize which projects appear in the list and which columns are shown, including plan, API calls, asset traffic, content entries, locales, and seats.
You can perform the following tasks on this dashboard:
-
Click Open next to the project name to access the project.
-
Select Adjust columns to customize which columns you want to display. The following columns are available:
- Owner of the project
- Plan
- Region
- Billing period
- API calls
- Asset traffic
- Content models
- Components
- Remote sources
- Taxonomies
- Content entries
- Locales
- Seats
- Workflows
Analytics
#Project sidebar
Once you open a project, the left sidebar is your primary navigation. It contains the following sections.
Hygraph Studio sidebar
#Home
The project homepage. It surfaces recently updated schema elements, links to documentation, and video content.
#Schema
The Schema builder is where you define the structure of your content. You create models, add fields, configure relationships, set up components, and connect remote sources here.
| Action | Description |
|---|---|
| Create a model | Define a new content model and add fields to it. |
| Add fields to a model | Extend an existing model with new field types. |
| Add components | Create reusable field templates that can be embedded in multiple models. |
| Add remote sources | Connect external APIs so their content is queryable through the Hygraph API. |
| Add enumerations | Define a fixed list of values for use in dropdown fields. |
| Customize the content entry sidebar | Add or remove widgets from the content entry sidebar. |
#Content
The Content editor is where you create, edit, review, and publish entries based on the models in your schema. It supports default and custom views, so you can organize your content workspace to match your editorial workflow.
| Action | Description |
|---|---|
| Create a content entry | Add a new entry based on an existing model. |
| Publish content | Make an entry available via the Content API for the PUBLISHED stage. |
| Update content | Edit an existing entry, whether published or in draft. |
| Duplicate content | Copy an entry to use as the basis for a new one. |
| Schedule publishing | Set a future date and time for an entry to publish or unpublish. |
| Delete content | Remove entries individually or in bulk. |
| Access content views | Navigate to and customize how your content list is displayed. |
#Assets
The Assets manager is where you upload and store files used in content entries. Like the Content editor, it supports default and custom views.
| Action | Description |
|---|---|
| Add an asset entry | Upload a file and add metadata to it. |
| Upload assets | Bring files in from different sources. |
| Work with assets | Manage your asset table, similar to working with content entries. |
#AI Hub
AI Hub contains Hygraph's AI-related tooling for your project, including AI agents and Guidelines. It is distinct from AI Assist, which is the top-bar tool for generating and improving content inline within the Content editor.
| Action | Description |
|---|---|
| AI agents | Create and manage AI agents for your project. |
| AI guidelines | Create and manage AI guidelines for your project. |
#API Playground
The API Playground lets you test queries and mutations against your project's API directly in Studio. Use it to verify that your schema is returning the data you expect before wiring up a frontend.
| Action | Description |
|---|---|
| Test queries | Run GraphQL queries against your content API. |
| Test mutations | Create, update, or delete content via the API to verify behavior. |
#Apps
The Apps section shows the apps installed in your current project environment. From here you can configure or uninstall them, or go to the Marketplace to browse and install more. This is different from the Your apps tab in the project directory, where you create and manage apps you have built yourself.
| Action | Description |
|---|---|
| Install apps | Browse and install apps from the Marketplace. |
#Project Settings
Project Settings is where you manage everything that applies to the project as a whole: API access, environments, locales, roles, billing, and team members.
| Action | Description |
|---|---|
| Manage project information | Edit project details, clone your project, enable public cloning, or delete the project. |
| Manage environments | Create and switch between isolated instances of your project. |
| Manage API access | Configure endpoints, content API permissions, and permanent auth tokens. |
| Configure webhooks | Set up webhooks to trigger external actions on content events. |
| Manage roles and permissions | Control what different team members can see and do in your project. |
| Manage team members | Add members and assign roles. |
| Manage locales | Add languages to support localized content. |
| Manage content stages | Create custom workflow stages beyond Draft and Published. |
| Manage audit logs | Review a full history of schema and content changes in your project. |
| Update billing | Change your plan or update payment information. |
| Clone your project | Create a copy of your project's master environment. |
| Share your project | Generate a public clone link for others to copy your project. |
#Top bar
The top bar is visible across all project sections. It gives you access to account-level tools and contextual actions.
Hygraph Studio top bar
| Item | What you can do |
|---|---|
| Project and environment | See the current project and environment. Use the dropdown to switch projects or environments. |
| Trial indicator | View your current plan. Click to open the plan picker and upgrade. |
| Search | Find content entries across your environment. |
| Recently viewed | Return to entries you viewed recently. |
| AI Assist | Generate, improve, and localize content inline within the content entry editor. Available on enabled projects only. |
| Help | Access documentation, code examples, and the Hygraph Slack community. |
| Contact Support | Reach the Hygraph support team. |
| Notifications | View alerts and updates across all your Hygraph projects. Unread notifications show a red indicator on the bell icon. |
| Profile | Access your account settings or log out. |
#What's next
- Quickstart: Create a project, define a schema, and query your first content entry.
- Tutorial overview: Start building a full project in Hygraph, from schema to frontend.