We just launched our new Hygraph Studio in beta. Learn more

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.

#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. Look into our Filters document to learn how to create custom 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: Just like regular content entries, assets can be saved without being published. 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. The process is similar to the one for content entries that you can find in our scheduled publishing document.

#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.