Contentful is a modern content infrastructure for content publishers. Their platform 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.

Brandfolder + Contentful is a powerful combination of digital asset management with the best headless (back-end only) CMS on the market. The integration allows you to use digital assets stored in Brandfolder within your Contentful entries.


  • Your Brandfolder API Key which can be found here
  • A content type with a field of type JSON object to hold the references to Brandfolder assets


Step 1: Install and configure

Under field assignment, select the content type fields that you want this app to be used for. Please note that only compatible fields of type JSON object are displayed here.


Click Install to finish the installation and save the configuration.


Step 2: How to use the app

To reference an asset on Brandfolder from your entry:

  • Click Select an asset on Brandfolder
  • Submit your Brandfolder API key in the dialog
  • Find an asset in Brandfolder using the dialog
  • Click Place
  • Repeat for as many assets as you wish to include in your entry

Submit API Key

Place Asset

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.

Editor View


What to do if the entry editor displays the warning Field value is incompatible?
The JSON object field of this entry already contains data that was not generated by the Brandfolder app. Please 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 select 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.


If you have any questions about this integration please contact

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