Tridion Sites Integration – Bynder Support

Would you like to add your Bynder assets to your Tridion Sites? Save yourself the time of uploading your assets twice and start using the the Tridion Sites integration. The integration allows you to use your Bynder assets directly in Tridion Sites. You can also search for your assets using keywords and navigate through the different result pages. The integration follows our API Rate Limiting policy.

Skip directly to

Supported versions
Derivatives used
Installation and configuration
Use the plugin

Watch a video

Prerequisites

Before you install the plugin, you need to have the following things set up:

A working Bynder account
Permanent tokens
Derivatives - see Derivatives (Create Image Variations)

Supported versions

The following versions are supported:

Tridion Sites 2013 SP1
SDL Web 8.1/Tridion Sites Sites 8.1
SDL Web 8.5/Tridion Sites Sites 8.5
Tridion Sites Sites 9
Tridion Sites Sites 9.1
Tridion Sites Sites 9.5

Derivatives used

Currently, derivatives are not supported. Tridion Sites downloads the original files from Bynder.

Installation and configuration

Download the plugin here. Alternatively, you can download the plugin from the SDL appstore. Next, do the following in your SDL environment:

Make sure you've created permanent tokens with the following scopes enabled:
- asset:read
- collection:read
- meta:assetbank:read
Create a Stub folder named BynderProvider in SDL (you will need its tcm uri on a later step) under > Building Blocks > Default Templates > SDL External Content.
Copy the BynderProvider directory to C:\ProgramData\SDL\SDL Tridion\External Content Library\AddInPipeline\Addins\

Open up your ExternalContentLibrary.xml in your SDL config directory (located usually in "C:\Program Files (x86)\SDL Web\config") and add the following:

<MountPoint type="BynderProvider" id="bynder" rootItemName="Bynder">
<StubFolders>
<StubFolder id="[STUB FOLDER TCM-URI]" />
</StubFolders>
<PrivilegedUserName>[SDL ADMIN USER]</PrivilegedUserName>
<BaseUrl xmlns="ecl:BynderProvider">[YOUR ENVIRONMENT URL]</BaseUrl>
<PermanentToken xmlns="ecl:BynderProvider">[BYNDER USER'S CONSUMER KEY]
</PermanentToken>

<AssetNotFoundPlaceholderId xmlns="ecl:BynderProvider">[BYNDER ID OF THE
PLACEHOLDER]</AssetNotFoundPlaceholderId>
<!-- Providing a placeholder will let you edit components that refer to assets that
are not available anymore -->

<DisplayMetaPropertyFolders xmlns="ecl:BynderProvider">[enabled/disabled]
</DisplayMetaPropertyFolders>
<HideEmptyMetaPropertyFolders xmlns="ecl:BynderProvider">[disabled/enabled]
</HideEmptyMetaPropertyFolders>
<!-- WARNING: Hiding empty folders will dramatically increase loading time if
number of assets is large -->

<AdditionalMediaPropertiesToShow xmlns="ecl:BynderProvider">
[value1,value2,value3,...e.g. views,dateCreated]</AdditionalMediaPropertiesToShow>

<!-- Force original file publishing for images -->
<AlwaysUseOriginalFileForImagePublishing>[disabled/enabled]
</AlwaysUseOriginalFileForImagePublishing>
<!-- Force original file publishing for videos -->
<AlwaysUseOriginalFileForVideoPublishing>[disabled/enabled]
</AlwaysUseOriginalFileForVideoPublishing>
<!-- Force original file publishing for certain file extensions, example: svg -->
<!-- list of comma-seperated file extensions -->
<AlwaysUseOriginalFileForExtensions>svg,3d</AlwaysUseOriginalFileForExtensions>

</MountPoint>

Note

Replace all variables with their value (variables are marked with []).

Apply the official SDL hotfix 6402

Depending on your SDL version (8.1*, 8.5* or 9.1*) follow the instruction provided in the following directories:
- 8.1 check the "ECL_8.1.1.6402" directory
- 8.5 check the "ECL_8.5.0.6402" directory
- 9.1 check the "ECL_9.1.0.17684" directory
Tip

If you're unsure about your SDL version, follow the following steps:
- Browse to "%TRIDION_HOME%\web\WebUI\WebRoot\bin"
- Search for files matching "Tridion.ExternalContentLibrary.*"
- Check the version of the file by displaying its properties and clicking the version tab.
Restart SDL services and verify that you can see the Bynder Provider folder and you can browse the assets in your environment through WebSDL.

Use the plugin

You can access your Bynder asset overview within Tridion assets by opening the Bynder Provider folder.
Use the Search box to search assets on keywords.
Click Toggle View to change to list view and filter the columns in your view.
When you use Bynder assets in SDL, we do not copy the asset but use its URL. In this way your CMS displays the latest version of the asset available in Bynder. To select an asset, open the Bynder Provider folder and select your asset.

Learn more