Integrate Bynder with Tridion Sites
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
Watch a video
Prerequisites
Before you install the plugin, you need to have the following things set up:
A working Bynder account
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.