Skip to main content

Knowledge Base

Tridion Sites Integration

Tridion Sites is a robust web content management solution that enables marketers to create, translate and deliver locally relevant digital experiences on a global scale.

The Tridion Sites Bynder integration allows you to use your Bynder DAM assets directly in Tridion Sites to ensure the latest versions are appearing in Tridion Sites. You can use Bynder CDN distribution as well as filter assets based on metadata when searching and browsing assets.

The integration follows our API Rate Limiting policy.

Skip directly to

How to enable the Tridion Sites Integration?

Contact your Customer Success Manager to learn more about Tridion Sites Integration.

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

  • Tridion Sites 9.6

How to set up the Tridion Sites Integration?

Caution

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

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

    • asset:read

    • collection:read

    • meta:assetbank:read

  • Make sure derivatives are set up in your portal to learn more click here

Note

Derivatives are fully supported including Dynamic Asset Transformation (DAT).

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

  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, for 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.

How to use the integration?

  1. You can access your Bynder asset overview within Tridion assets by opening the Bynder Provider folder.

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

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

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