Embedding Assets with Smart CDN

With Brandfolder's Smart CDN, you can embed assets across the web and format them on-the-fly to meet your specific needs. CDN links ensure your content always reflects the most up-to-date changes made to your Brandfolder Asset.

How Do I Embed a Single Asset?

Embedding a single asset in your website or landing pages can make updating the assets across multiple pages easy and accessible for all users.

  1. Click into an Asset.
  2. Select the Embed tab. (if you don't see that option please contact support@brandfolder.com to enable that on your account).
  3. Copy and paste the URL. 

CDN URL Embed Options:

    • CDN Link - Attachment: This allows users to embed the attachment without having to worry about position. It is a direct link to the attachment and is the most optimized version of the asset. A custom set of parameters can also be added by default on all attachment urls.
      • NOTE: Must be on v2.1 of CDN in order to add default custom params to your CDN urls.

Other Options Available Under Additional CDN Links:

  • CDN Link - Asset: This allows a user to embed an attachment which will update based off of the position in relation to the other attachments.
  • CDN Link - Attachment (original file): This URL references the original attachment CDN URL without any predefined conversions or optimizations (params).
  • CDN Link - Frame: This CDN URL option is useful for automatically resizing based on the container it is inside.



You can place this link in an image tag like <img src="link_here"> and when you update the asset, it will update the link wherever it lives. If an asset has multiple attachments, whatever attachment is in the top position will be displayed using this link.


Advanced Smart CDN Features

Transformation and Conversion:

In addition to efficiently serving up assets to external sites, Smart CDN supports on-the-fly file transformations and conversions.

For example, let's say you have a Smart CDN URL such as https://cdn.brandfolder.io/YUHW9ZNT/as/6skcfbkq/brandfolder_icon_aqua.png.

If you want the same image with specific dimensions, simply specify that in the URL like so: https://cdn.brandfolder.io/YUHW9ZNT/as/6skcfbkq/brandfolder_icon_aqua.png?width=150.
Want a JPG instead PNG? Just change the extension at the end of the URL: https://cdn.brandfolder.io/YUHW9ZNT/as/6skcfbkq/brandfolder_icon_aqua.jpg
Need a larger version of your file? Bump up the height or width params in the URL and add &pad=true  to add whitespace padding to the original image.


Auto Extension:

The Brandfolder CDN will allow you to use the extension of .auto on v1 or auto=webp on v2.  We will automatically choose the best format for the browser that is loading the image.  This includes sending images back using the WEBP format, which lowers the size of an image, without loss, and speeds the loading of the image on your site.
Smart CDN allows you to link to any attachment inside your asset, not just the first one. Say your asset has multiple attachments, and you want the fourth attachment in your asset, just specify that by adding, ?position=4 to the end of your CDN url: https://cdn.brandfolder.io/C0KGG2P6/as/pd20zo-6xxwds-g0sj9j/CDN%20Example.png?position=3.
Use any combination of the above to modify your CDN link to get your Brandfolder Attachments exactly how you need them for your use case.

Live Updating:

Any time you update an Asset in Brandfolder, associated Smart CDN links embedded throughout the wild will also update to reflect those changes.

Automatic Expiration:

If you expire, un-approve or delete the asset in Brandfolder, the Smart CDN link will automatically expire as well (it may stay cached for up to 24 hours).

Contact Support@brandfolder.com to manually expire the cache if you need it to expire faster, which usually takes about 10-15 minutes for it to change across the world.


Embedding Video Assets

Embedding video assets is slightly different than image assets.  Brandfolder provides a basic iframe with our video player embedded into it.  Users can control the size of the iframe as well as a number of optional parameters for videos.

Example Embedded Video

Example Embed Code


Allows video to loop after it has finished playing.

  • loop
  • default: false
  • options: boolean - true or false


Determines whether sound is muted when the player loads.  This is useful for when using autoplay setting due to browser autoplay restrictions.

  • muted
  • default: false
  • options: boolean - true or false


 Automatically play the video upon load.

  • autoplay
  • default: false
  • options: boolean - true or false


CDN v2.1 

CDN v2.1 is now available by request! Below are some enhanced features users can expect:

  • Faster rendering of files via the CDN url
  • A more robust set of params available for use found here
  • A more reliable and hardened outcome of processing
  • Ability to set custom params on all CDN urls that will also be available when the CDN URL is requested via the API



Using Brandfolder to autoplay a video when a page loads is not a simple issue. This stems from browser vendors responding to user wishes to NOT have videos autoplay. The most reliable way is to set autoplay=true&muted=true since many browsers (including Chrome) will not autoplay videos with audio.

Be careful not to delete the asset when using this feature! 


If you have any questions on CDN or embedding assets please reach out to the support team at support@brandfolder.com

Was this article helpful?
1 out of 1 found this helpful