Contentful is a modern content infrastructure for content publishers that lets users 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.


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

Configuring 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



Navigating the integration

To reference an asset on Brandfolder from your entry:

1. Choose Select an asset on Brandfolder. 

2. Submit your Brandfolder API key. 

3. 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).   

4. Once you are at the Brandfolder or Collection level you have a few options to narrow down your content.

    • You can search assets by inputting search syntaxes into the search bar. Various search syntaxes are outlined in the Searching in Brandfolder Knowledge Base article
    • You can select the pin icon in the search bar to utilize pinned searches. 
    • You can filter by asset status, tags, file types, custom fields, orientation, SKU, and upload date by selecting the filter button below the search bar.
    • You can search for labels by selecting the label button next to the Filter button.

5. You can view asset details by hovering over the asset, selecting the ellipses, and choosing view asset details.

Utilizing Brandfolder assets

  1. Repeat for as many assets as you wish to include in your entry.
  2. Previews of your assets will now appear in your entry. These can be reordered by dragging and dropping or removed by clicking the X in the upper right corner.



If the entry editor displays the warning Field value is incompatible?
Then the JSON object field of this entry already contains data that was not generated by the Brandfolder app. Ensure that you've selected the correct field in the app configuration to be used with Brandfolder, and that you no longer need the previously entered data. Then choose, I want to override the value using the App., which will initialize the field with an empty selection. Now you can start to add assets to your entry.

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

Was this article helpful?
0 out of 0 found this helpful