Knowledge Base

Mark assets as public

If you have a webshop and want to use images from Bynder on your website, then the images you use need to be public and retrievable through the API. You might also want to make some of your assets public and visible and downloadable to all.

For information on creating public collections, see Create, share and manage collections.

If your files are not public, they are private, which means that users who are not logged in cannot see or download them.

Note

Making an asset public doesn't make its derivatives public.

How to enable this feature?

Contact your Customer Success Manager if you would like to have this feature enabled for your portal.

How to mark an asset as public?

  1. Select one or more images in the asset overview and edit them, or click an asset and click the Edit tab on the Asset detail page.

  2. Expand the Advanced Rights tab.

  3. Select Mark as public. When an asset is marked a public a publicly accessible URL is created for this asset. Any user who has the URL can then view and download the asset.

    Note

    • Making an asset public allows external users to open the asset link if you share the link with them. If you decide to make a file public, you will not be able to clear the checkbox and make it private again. You can only delete or archive a public file.

    • If your public files are served through our CloudFront CDN, their link can refresh real-time. For example when you upload a new version of the file, the link can get updated so that the latest version automatically displays on your external website. Read more about our automatic invalidation process here.

    • Thumbnails and webversions are public by default. To change this, see Share thumbnails in a more secure way.

Marking an asset as public makes the original asset public. The URLs to view the original image and the derivatives can now be retrieved via the API. If you want only specific derivatives to be public contact your Customer Success Manager or Onboarding Manager for help with the setup.

Public URLs

Currently public links are build up with the following formats:

Original file

https://YourPortalURL.com/m/[idhash]/original/[asset-name].[file-extension]idhas

Derivative

https://YourPortalURL.com/m/[idhash]/[derivative-prefix]-[asset-name].[file-extension]idhas

/m/

The /m/ element indicates that it is a public link.

idhash

The idhash is a hash based on the mediaID. It's a 16-character hexadecimal string.

original

This indicates that the URL links to the original file.

derivative-prefix

This is a mandatory reference to determine which derivative of the asset to use

asset-name

This value represents the name of the asset.

file-extension

The file extension of the original file or derivative.

Customize Public URLs

You can customize your public URLs. Any text behind the /original/ or derivative-prefix- element can be replaced with your own text. Based on the idhash the system can still redirect users to the correct public original file or public derivative.

Example

The two public URLs below link to the original file and to the 'socialmedia' derivative. This is the default non-customized version of both URLs

https://YourPortalURL.com/m/2dca1fb32bd065d1/original/Bynder-Logo-Blue.png

https://YourPortalURL.com/m/2dca1fb32bd065d1/socialmedia-Bynder-Logo-Blue.jpg

Optionally, the text behind the orginal and socialmedia- elements can be fully removed or customized. You can make the changes in your preferred text editor. The following URLs could for example also be used:

https://YourPortalURL.com/m/2dca1fb32bd065d1/original/Bynder-Logo.png

https://YourPortalURL.com/m/2dca1fb32bd065d1/socialmedia-Logo.bmp

Note

  • You cannot make the URL customizations in the portal itself. The changes can also not be saved to the portal.

  • Customizing the file extension will not actually change the file format of the actual file. If you change .jpg to .bmp the file will remain a .jpg file.

Public URLs in asset detail view

By default, public derivatives are only accessible through the API and are not visible to users on the Asset detail page. If you want to make them visible, contact your Customer Success Manager or Onboarding Manager.

Retrieve assets via the API

You can retrieve your assets via the API. By default, the URLs to view the derivatives of image assets will be returned by the API. When you visit this type of URL the derivative will be displayed in the browser. If your marked the assets as public the link to view the original image file will also be returned. These 'viewing' links are valid permanently. You can find more information about this type of API call here.

If you want to offer your users a link to download original image assets or their derivatives you can also retrieve download URLs via the API. These download URLs expire after 6 hours. Read more about this API call here.

Public assets and search engines

Do you have public assets or and do you want to know whether they can be indexed by search engines. Read more about it here.

Learn more