Umbraco Connector
Overview

Bynder Connector for Umbraco

The Bynder connector for Umbraco brings your approved brand assets straight into the Umbraco backoffice. Editors search, filter and pick Bynder images, videos and documents without leaving the page they're working on, instead of downloading files from Bynder and uploading them again.

Assets are stored by reference, not copied into the Umbraco media library. Bynder stays the single source of truth, and your website always serves the public, channel-ready rendition the editor chose.

The Umbraco connector supports modern Bynder (opens in a new tab) portals only. Webdam by Bynder (opens in a new tab) portals are not supported.

Key Features

  • Bynder Universal Compact View (UCV) - Picking uses Bynder's own Universal Compact View, with native Bynder search, filtering, collections and derivative selection. See Understanding Universal Compact View (UCV) (opens in a new tab)
  • Bynder Asset Picker - A property editor for one or more Bynder assets, rendered through a default image and video output (derivative)
  • Bynder File Picker - Lets editors pick a specific omnichannel output, such as a crop or format made for one channel
  • Your Bynder permissions apply - Editors sign in with their own Bynder account inside the picker, so they only see the assets they're allowed to use. The connector doesn't store a shared Bynder login
  • Field-level controls - Limit each picker to asset types, tags, a collection or metaproperty options, and pre-fill a search term
  • Rich text editor integration - Embed Bynder images and documents directly in rich text
  • Umbraco Media fallback - A picker can also accept a regular Umbraco Media item, so you can move to Bynder step by step without breaking existing content
  • Asset Tracking (optional) - Bynder shows which Umbraco pages use each asset, and Umbraco shows which Bynder assets each page uses
  • Meta Data Sync (optional) - Alt text and copyright stay in sync with Bynder without republishing content
  • Transcript Sync (optional) - Bynder's speech-to-text transcripts become WebVTT subtitle tracks for video and audio
  • Headless ready - Both pickers support the Umbraco Content Delivery API
  • Developer friendly - Strongly typed models, Razor rendering helpers, appsettings.json IntelliSense and a ready-made Log Viewer search
  • Localised - The backoffice UI is available in 25 languages

Supported Umbraco Versions

Umbraco 17 - every 17 release, from 17.0.0 up to the latest 17.x.

The connector's version number follows {Umbraco major}.{minor}.{patch}: install a 17.x version for Umbraco 17. Support for a new Umbraco major is released as a new major version of the connector.

Requirements

  • An Umbraco 17 site (any 17.x release), running on .NET 10
  • A Bynder portal (Webdam is not supported), for example yourcompany.getbynder.com, and a Bynder user account for each editor
  • A Bynder integration portal account - Your API key from the portal is the connector's license key. See Portal & Account Setup to sign up and retrieve it
  • Optional: Bynder admin rights to create an OAuth app, only needed for the optional features

License and Trial

The connector needs a valid license key. Register an account on the Bynder integration portal (opens in a new tab) to start a free two-month trial. After the trial, subscriptions are purchased from Bynder, and the key for your subscription is managed on the same portal.

  • If the licensing service can't be reached, a key that was confirmed valid within the last 72 hours keeps working, so a short outage doesn't lock editors out.
  • If a subscription ends, only the Umbraco backoffice functionality stops: opening the Universal Compact View, and syncing and tracking. Content already published on your website keeps working, because Bynder assets are served from Bynder's own links.

Getting Started

  1. Installation - Install the NuGet package and add your license key
  2. Configuration - Connect your Bynder portal, create Data Types and enable the rich text editor
  3. Optional Features - Asset Tracking, Meta Data Sync and Transcript Sync
  4. Rendering Assets - Render Bynder assets in Razor or through the Content Delivery API
  5. Troubleshooting - Check the installation and solve common problems

Resources

TroubleshootingInstallation