Contentful integration

Use assets stored in Brandfolder within Contentful.

Who can use this?

Plans:

  • Brandfolder

Permissions:

  • Owner
  • Administrator

Find out if this capability is included in Smartsheet Regions or Smartsheet Gov.

Contentful is a modern content infrastructure for publishers to create, manage, and distribute content to any platform. Unlike a traditional Content Management System (CMS), Contentful provides total freedom to create unique content models.

The Brandfolder Contentful integration allows you to use digital assets stored in Brandfolder within your Contentful entries.

Requirements: 

  • Your Brandfolder API key is in your profile under integrations. 
  • A content type with a field of type JSON object to hold the references to Brandfolder assets. 

Configure the integration

  1. In the Contentful marketplace, find the Brandfolder App and select Install Now.
  2. Under field assignment, select the content type fields you want this app to use. Only compatible fields of type JSON object are displayed.
  3. Select Install.

Navigate the integration

To reference an asset on Brandfolder from your entry:

  1. Select Select an asset on Brandfolder. 
  2. Submit your Brandfolder API key. 

Your Brandfolder content will appear. The integration panel allows you to navigate your content just like you would within the Brandfolder by visiting the different levels of the Brandfolder hierarchy (Organizations, Brandfolders, and Collections).    

  1. Once you are at the Brandfolder or Collection level, you have the following options to narrow down your content.
    1. Search assets by inputting search syntaxes into the search bar.
    2. Select Pin  Pin an item. Next to the search bar, utilize pinned searches.
    3. Filter by asset status, tags, file types, custom fields, orientation, SKU, and upload date by selecting the Filter icon next to Pin.
    4. Search for labels by selecting the Label icon below the search bar.
    5. Filter by section or collection by selecting the arrow to the right of All Sections or Collections.
  2. You can view asset details by hovering over the asset, selecting the ellipses, and selecting View Details.

Why is my entry editor displaying the warning Field value is incompatible?

This means that this entry's JSON object field already contains data that was not generated by the Brandfolder app. 

Ensure you've selected the correct field in the app configuration to use Brandfolder and that you no longer need the previously entered data. Then select "I want to override the value using the App" which will initialize the field with an empty selection. Now, you can start adding assets to your entry.

To access the underlying field value, deselect the field in the Brandfolder app configuration. This resets the editor to the default JSON display for object fields.