Knowledge Base

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:

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:

  1. Make sure you've created permanent tokens with the following scopes enabled:

    • asset:read

    • collection:read

    • meta:assetbank:read

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

  3. Copy the BynderProvider directory to C:\ProgramData\SDL\SDL Tridion\External Content Library\AddInPipeline\Addins\

  4. 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 []).

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

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

    asset-overview-tridion.png
  • Use the Search box to search assets on keywords.

  • Click Toggle View to change to list view and filter the columns in your view.

    list-view-sdl.png
  • 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.

    use-asset-sdl.png

Learn more