Frequently Asked Questions

Asset Manager Features & Capabilities

What is the Hygraph Asset Manager and what can it do?

The Hygraph Asset Manager is a built-in feature available in every Hygraph project by default. It allows you to manage all types of assets, including images and files. With the Asset Manager, you can fetch, reference, transform, upload, update, publish, localize, delete, and embed assets. It supports both single and bulk actions, making asset management efficient for teams of all sizes. Learn more.

What types of files can I manage with the Asset Manager?

The Asset Manager supports any file type, though it is most commonly used for images. You can upload, store, and manage documents, images, and other file formats as assets within your Hygraph project.

How do I upload assets in Hygraph?

To upload assets, navigate to the Assets tab in your project and click the Upload button. You can upload files from your device, provide an asset URL, search images via web search, or connect to Facebook, Instagram, or Google Drive to select assets. You can upload multiple assets at once and manage them before finalizing the upload. See upload steps.

What actions can I perform on assets in the Asset Manager?

Within the Asset Manager, you can filter, edit, configure columns, clear selections, show selected entries, publish, delete, and schedule assets. Bulk actions are supported for publishing, deleting, and scheduling. You can also preview assets, open entries, and customize the asset model to include metadata like captions. More details.

How do I add metadata or captions to assets?

You can add metadata, such as image captions, to assets if your project configuration allows it. The asset model can be customized by a system administrator to include additional fields. The fields available are the same as those that can be added to any model in Hygraph. Learn more about adding asset entries.

Can I schedule asset publishing or deletion?

Yes, you can schedule publishing or unpublishing of assets, as well as add them to new or existing releases. When scheduling, you can select the action (publish or unpublish), date, time, and time zone, and choose which locales to include. See scheduling options.

What views are available for browsing assets?

You can switch between grid and table views to browse your assets. The grid view displays assets as thumbnails, while the table view lists them with details. Both views support selection, preview, and bulk actions. Learn more about views.

How do I integrate external asset management tools like Bynder or Cloudinary?

Hygraph supports integration with external asset management tools such as Bynder and Cloudinary. Once integrated, you can select assets directly from your Bynder or Cloudinary account within the content editor. The integration process depends on your project configuration and connected apps. Integration details.

Security & Compliance

How does Hygraph ensure the security and compliance of asset management?

Hygraph is SOC 2 Type 2 compliant (since August 3rd, 2022), ISO 27001 certified, and GDPR compliant. Security features include granular permissions, SSO integrations, audit logs, encryption at rest and in transit, and regular backups. These measures ensure that your assets and data are protected according to industry standards. See security details.

Performance & Usability

How does Hygraph optimize performance for asset delivery?

Hygraph uses Smart Edge Cache and high-performance endpoints to ensure fast and reliable content and asset delivery, even for high-traffic and global audiences. The platform's GraphQL API is optimized for speed and scalability. Read more about performance improvements.

Is the Asset Manager easy to use for non-technical users?

Yes, Hygraph's Asset Manager is designed with an intuitive user interface that is accessible to both technical and non-technical users. Customers have praised its ease of use, and Hygraph was recognized for "Best Usability" in Summer 2023. See user feedback.

Support & Implementation

What support is available if I have issues with asset management?

Hygraph provides 24/7 support via chat, email, and phone. You can also access real-time troubleshooting through Intercom chat, join the community Slack channel, and consult extensive documentation and training resources. Enterprise customers receive a dedicated Customer Success Manager. See support options.

How quickly can I start using the Asset Manager?

You can start using the Asset Manager immediately with a free developer account or API playground. For larger projects, Hygraph offers a structured onboarding process, including introduction calls, account provisioning, and training resources. Get started.

Pricing & Plans

Is the Asset Manager included in all Hygraph plans?

Yes, the Asset Manager is included in every Hygraph project by default, including the free developer account and all paid plans. For more details on plan features and pricing, visit the Hygraph Pricing Page.

Use Cases & Success Stories

What are some real-world use cases for the Asset Manager?

The Asset Manager is used by companies across industries such as ecommerce, technology, manufacturing, and more. For example, Burrow uses Hygraph for product inventory management, and Komax manages over 20,000 product variations across 40+ markets. See case studies.

Help teams manage content creation and approval in a clear and structured way
Hygraph
Docs

#Asset manager

#Overview

The Asset model is included in every project by default. It is commonly used for images, but can also support any file type. Assets can be fetched, referenced, transformed, uploaded, updated, published, localized, deleted, and embedded.

As an Editor, you may have to add assets to content entries using the asset picker field.

#Switch views

You can choose whether you want your assets to display in a grid or table view.

You can find the switch at the top of the screen:

Switch asset viewsSwitch asset views

#Table view

This is what the table view looks like:

Assets - Table viewAssets - Table view

Users can open the asset entry by clicking on a table item, or use the checkboxes to perform single or bulk actions.

#Grid view

This is what the grid view looks like:

Assets - Grid viewAssets - Grid view

  • Open an entry: Open an asset entry by clicking anywhere on the thumbnail or the title.
  • Preview asset: Click on the eye icon on an asset card to open a large asset preview. This icon appears on hover.
  • Asset selection: Select boxes appear on hover. Selecting an asset activates selection mode. As a result:
    • A deselect all button appears at the top of the grid.
    • All checkboxes become visible on all assets.
    • Clicking on asset cards will not open the asset in selection mode.

#Work with assets

If you have access to the Assets section of the app, you will see that the screen displays all uploaded assets in a table. On this screen, you can perform the following actions:

  • Filters: Filter assets by name, or add new filters by clicking on + Filter and selecting one from the list. Here you can find detailed information on how to work with filters.
  • Edit: Edit the details of an asset entry by clicking on the pencil icon.
  • Configure columns: This option allows you to configure the columns that display on the assets table. When you click on this link, a dropdown allows you to select/deselect columns using checkboxes. Here you can find detailed information on how to configure columns.
  • Clear selection: This option displays only if at least one item from the list has been selected. It clears the selected items.
  • Show selected entries: This option displays only if at least one item from the list has been selected. Clicking on this option displays only the selected items on the list.
  • Publish: This option displays only if at least one item from the list has been selected, and starts the publishing process. Clicking on Publish prompts a pop up screen where you can use checkboxes to select whether non localizable fields and/or the default localization fields will be published, before clicking on the Publish button to finish the process. You can publish entries in batch by selecting multiple entries then clicking on Publish, but please consider that when using batch-publishing, non-localized fields and the default localization will always be published.
  • Delete: This option displays only if at least one item from the list has been selected. Clicking on Delete results in the elimination of the selected entries. Please consider that this change is permanent and cannot be rolled back.
  • Schedule: This option displays only if at least one item from the list has been selected. Clicking on Schedule prompts a pop up screen where you can schedule publication by selecting one of the following options:
    • Schedule entry only: This option schedules an entry individually. After selecting this option, you'll select an Action (publish, or unpublish), a date and time, and a time zone. You can also use checkboxes to select which additional locales are published/unpublished - non-localized fields and the default localization will always be published.
    • Add to an existing release: This option allows you to select from existing releases that need to have been previously configured in your content editor. If you have configured releases, then you will be able to select one from a dropdown menu after selecting this option. Otherwise, the following message displays: No releases available, please add one.
    • Add to a new release: This option allows you to create a new release and add the current entry to it. After selecting this option and giving your new release a Name and Description, you'll select an Action (publish, or unpublish), a date and time, and a time zone. You can also use checkboxes to select which additional locales are published/unpublished.

#Upload asset

  1. Navigate to the Assets tab of your project and click on the Upload button, located at the top right corner of your screen.

  2. Select an asset source from the popup screen. Uploading an asset from your device is the default option, but you can select different options:

    • Upload an asset from your device.
    • Provide an asset URL.
    • Search images through web search.
    • Connect the project to a Facebook account to select an asset from it.
    • Connect the project to an Instagram account to select an asset from it.
    • Connect the project to a Google Drive account to select an asset from it.

    You can add assets from one or more of these sources.

  3. As you select multiple assets, the pop up screen will display them on a list, where you will have the following options:

    • Filter: You can filter assets by name. This is specially useful when you need to find a specific asset in a long list.
    • Edit: The Edit option allows you to crop the image, create a circular image using part of it, or rotate it.
    • Eliminate: The Eliminate option simply removes the asset from the list.
    • Deselect all: This button clears the assets list.
  4. Upload more: Optionally, you can upload multiple assets at the same time. To do this, click on Upload more, or click on one of the asset source icons then select a new one.

  5. Upload: This button finishes the process by uploading all selected assets. As a result, the assets will display in the uploaded assets list in stage DRAFT. Don't forget that for a content entry that you publish to display correctly, all associated assets need to be PUBLISHED as well.

#Add asset entry

Out-of-the-box this process works as follows:

Assets - Add EntryAssets - Add Entry

To add an asset entry, navigate to the Assets tab of your project and click on the + Add entry button, located at the top right corner of your screen.

Unlike our regular asset upload, when you add an asset entry you may have more options depending on configuration, such as the possibility to add a caption.

Asset is a system model that appears by default in every Hygraph project. So, a system administrator could edit this asset model to include other necessary information. This asset model configured in your project's schema will determine the data you can add to an asset entry.

This is what the Add asset entry screen looks like by default:

Assets - Add EntryAssets - Add Entry

Besides the metadata - that may or may not display here depending on configuration - the + Add entry screen has an Upload button that displays the same options as our regular asset upload.

The following is an example of what the option to create an asset would look like having a caption field:

Asset picker - customizedAsset picker - customized

While it's not possible for us to anticipate all possible customizations of this field, know that if this screen does not display the default view, customization is the reason.

#Integrations

Some apps that manage assets can be integrated with your project. This section contains information on how to use them.

Whether this is available to you or not, depends on project configuration and integrated apps.

#Bynder

  1. Navigate to the Content editor.
  2. Select the view that you will be working on.
  3. Click on + Add entry at the top right of the screen or, alternatively, edit an existing entry by clicking on the pencil icon.
  4. Locate the Bynder asset section of the screen and click on Select asset from Bynder. A new screen displays showing the assets available in your Bynder domain.
  5. Select the asset you want to add to the entry, then click on Add asset.
  6. Now that the asset has been added to the entry, you can click on Save or Save & Publish, depending on the workflow you follow.

#Cloudinary

  1. Navigate to the Content editor.
  2. Select the view that you will be working on.
  3. Click on + Add entry at the top right of the screen or, alternatively, edit an existing entry by clicking on the pencil icon.
  4. Locate the Cloudinary asset picker section of the screen and click on Add from Cloudinary. A new screen displays showing the assets available in your connected Cloudinary account.
  5. Select the asset you want to add to the entry, then click on Add asset.
  6. Now that the asset has been added to the entry, you can click on Save or Save & Publish, depending on the workflow you follow.