Easily restore your project to a previous version with our new Instant One-click Backup Recovery
Hygraph
Docs

App walkthrough

#Overview

Welcome to our Hygraph app walkthrough. This document will show you the entire app.

We'll go over each section and discuss what you can do in them.

At the end of the document you'll find a special section listing & describing actions and where they are located in the app.

#Project directory

You land on your project directory after logging in:

Project directoryProject directory

Here you can find two tabs at the top, one for Projects and another one for Your apps. If you have created any apps, you will find them in the Your apps tab.

Project directory - Your appsProject directory - Your apps

The Projects tab contains the following:

  • Project invites: If you have any invites pending acceptance, you will find them at the top of the page. Project inviteProject invite
  • Projects: If you have any projects, you will find one card for each here.
  • Starters: Scroll down the screen to find our starter projects.

At the top right of the screen, you will also find a link to contact support, and your account settings.

Project directory - Contact support & Account settingsProject directory - Contact support & Account settings

#Homepage

The Homepage is the section of a project you land on when you first create it, and every time you access it after that.

It contains widgets that will help you to easily navigate to your recently updated schema elements, find useful documentation, or access our video content.

#Schema builder

Your schema is defined by the models you create, and fields you add. It is the backbone of your Hygraph project. In the Schema builder you'll define the structure of your content by adding fields, creating relationships between models, and much more.

#Content editor

The Content editor is where you create, edit, publish and unpublish content using the structure of the schema you previously created.

The Content editor presents default and custom views for you to access your project's contents. It also allows the possibility of reloading your content, previewing it in the API Playground, or viewing the model.

#Assets manager

The Digital asset manager - or Assets - is where you upload and store documents to be used in your content entries.

The Assets tab presents default and custom views for you to access your uploaded assets.

#API Playground

You can use the API Playground to test out API calls, by experimenting with querying and mutating data.

#Mutations

Look into mutating data in our API Playground.

#Endpoints & permissions

Find your endpoints in the UI by navigating to your project settings and learn about permissions.

#Other features

FeatureDescription
NotificationsThe Notifications section informs you of comments assigned to you in content entries. If you have unread comments, a red mark will appear on the bell icon. This section picks up notifications from all your Hygraph projects.
AppsThe Apps section is where you can configure or uninstall apps from your project. Each installed app will display in a card, where you will have the option of editing its configuration by clicking on the pencil icon, or uninstalling it by clicking on the trash icon. The configuration options depend on the app, they are the ones you initially set up during installation. You can also find a link to our Marketplace at the top, where you can browse the apps you can install.
WebhooksIn the Webhooks section, you can add webhooks to your project's deployment according to triggers you can configure. This section displays each webhook in a card, with options to edit its configuration, view its logs, and delete it.
Project settingsThis is where you can access your project's global information, and manage its settings. This screen contains both, general and access settings.

#Where do I...?

ActionWhere in HygraphDescription
Create a modelSchema BuilderYour schema is the content structure of your project. You can define your schema by creating models and adding fields to them.
Add fields to my modelSchema BuilderYou can add fields to your models to define your project schema.
Customize my sidebarSchema BuilderYou can configure schema sidebar adding and/or removing system and custom widgets.
Add componentsSchema BuilderYou can create components to use them as flexible, reusable templates where you define the fields once - in the Schema - and then fill them with different content every time you use the component in a content entry.
Add remote sourcesSchema BuilderYou can use remote sources to add content from other systems and sources to the Hygraph API without having to migrate the content itself.
Add enumerationsSchema BuilderYou can use enumerations to group values within a type, or to create a list of values, which can then be used when adding a dropdown field to your models.
Schedule publishingContent EditorYou can schedule content publishing, and unpublishing as single entries, or group them as part of a release.
Create contentContent EditorYou can create content entries based on the models you created in your schema.
Publish contentContent EditorYou can publish content so it can be consumed by others.
Update contentContent EditorYou can update content you've already created, whether it's been published or not.
Duplicate contentContent EditorYou can easily duplicate content, which saves time during content creation of similar entries.
Delete contentContent EditorYou can delete content entries individually or in bulk, and you can also delete related content.
Access created contentContent EditorYou can navigate to the content editor to access your content. This experience can be customized.
Add an asset entryDigital Assets ManagerYou can upload assets and add metadata to them, providing you've added metadata fields to the Assets model.
Upload assetsDigital Assets ManagerYou can quickly upload assets from different sources into the CMS.
Work with assetsDigital Assets ManagerYou can work with your assets table in a similar way as you would with content entries in the Content editor.
Manage notificationsNotificationsYou can use our commenting feature to manage notifications and work collaboratively with your team.
Install integrated appsAppsYou can install apps from our Marketplace in your Hygraph project to enhance its capabilities.
Configure webhooksWebhooksYou can configure webhooks to trigger actions in your project.
Manage my project's global informationProject settingsYou can access your project settings to edit your project details, clone your project, enable public cloning and even delete your project.
Clone my projectProject settingsYou can create a copy of your project's master environment by cloning it.
Delete my projectProject settingsYou can delete your project from project settings.
Share my projectProject settingsYou can enable public cloning to share a link that other people can use to clone your project.
Manage my project environmentsProject settingsYou can use different environments to safely work on isolated instances of your project.
Manage audit logsProject settingsYou can access audit logs to see all changes inside of your project. They contain both changes in the schema and content.
Manage my project's content stagesProject settingsYou can manage your content stages to create custom workflows.
Manage my project's localesProject settingsYou can add locales to include content in different languages.
Manage your billing informationProject settingsYou can update your billing information by accessing your project settings.
Manage API accessProject settingsYou can manage API access from your project settings. Manage your endpoints, content API permissions, and permanent auth tokens.
Manage roles and permissionsProject settingsYou can manage roles and permissions to create efficient workflows and build independent teams.
Manage team membersProject settingsYou can add members to your Hygraph project and overview the roles they have been assigned to.