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 Media Manager Contentful integration allows you to use digital assets stored in Media Manager within your Contentful entries.
Requirements:
- Your Media Manager API key, is in your profile under integrations.
- A content type with a field of type JSON object to hold the references to Media Manager assets.
Configuring the integration
- In the Contentful marketplace, find the Brandfolder App, and select Install now.
- Under field assignment, select the content type fields you want this app to use. Only compatible fields of type JSON object are displayed.
- Select, Install.
Navigating the Integration
To reference an asset from your entry:
1. Choose Select an asset on Media Manager.
2. Submit your Media Manager API key.
3. Your Media Manager content will appear. The integration panel allows you to navigate your content just like you would within the library by visiting the different levels of the hierarchy (Organizations, Libraries/Brandfolders, and Collections).
4. Once you are at the Library/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 for content 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 Media Manager assets
- Repeat for as many assets as you wish to include in your entry.
- 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.
Troubleshooting:
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 Media Manager app. Ensure that you've selected the correct field in the app configuration to be used with Media Manager, 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 Media Manager app configuration. This will reset the editor to the default JSON display for object fields.