Content delivery and public links

Each file uploaded to Orange Logic can have derivative formats in various resolutions and sizes. You can control asset expiration and takedown for each individual format.

Image formats

Orange Logic supports both AVIF and WebP file types, which are compressed file types that are smaller than JPG and PNG files. Therefore, they can be delivered to users more quickly while maintaining quality. AVIF and WebP files types are not supported by all browsers, but most modern browsers support at least one of these file types.

We recommend using the Automatic filename extension to ensure you’re delivering the optimal image file type in every situation. When you use this extension, Orange Logic detects which file types a user’s browser is capable of handling, then serves them the image in the most compressed file type their browser accepts. This improves the user experience by decreasing loading time for users with modern browsers while simultaneously ensuring users with older browsers can load the images.

Images that are delivered with the automatic filename extension have URLs that end with .auto. For example:

https://mango-atelier-cdn.mangovations.com/backtoschoolblouse-heroimage.auto

The .auto extension prioritize AVIFs, so users receive the highest quality file at the quickest speed. If AVIF is not supported, images are delivered as WebP. The final fallback is JPG.

Default quality levels

Orange Logic compresses each image format to a default quality based on the file type, using a quality scale from 0 to 100 where 0 is the most compressed (lowest quality, smallest file), and 100 is not compressed (highest quality, largest file).

Default qualities:

• AVIF: 57
• WebP: 70
• JPEG: 75

You can use transformations to customize the quality.

Video formats

The Orange Logic platform has multiple options to ensure videos load quickly, including support for streaming and non-streaming formats, as well as manual downloads of web-ready files. We recommend automatically generating one link to each of these options for end users, so they can choose the best link to include in their content.

Streaming format (HLS)

🚧

Caution

An Orange Logic specialist can configure the platform to automatically generate HLS formats when videos are uploaded. HLS is not yet available for public embed links.

HLS is a video streaming protocol that offers viewers the best possible video quality with minimal buffering. We suggest using HLS for all video players and sites that support it. Video streaming quality depends on two things:

• A user’s network bandwidth, or the maximum amount of data that can be transferred over an internet connection in a given amount of time.
• A user’s video bitrate, or the amount of data that the video transmits per second.

A higher bandwidth and bitrate is usually better. However, when a video’s bitrate is higher than the network bandwidth, the video player cannot stream the video fast enough to keep the video playing, which causes buffering. Network bandwidth can vary frequently as a user moves around or changes networks. For example, users might stream videos on their home network, then switch over to their mobile network or a public network when they leave their home. To deal with network changes, HLS uses adaptive bitrate streaming.

Here’s how adaptive bitrate streaming works.

• A video is split into short segments (approximately 10 seconds).
  • Each segment is created in several different variants.
  • Each variant has a customized bitrate and size.
• The video player picks the best variant for the next segment, taking into account the user’s current network bandwidth. This provides the best possible quality, given a user’s network bandwidth at that moment.

Recommended streaming (HLS) variant ladder

We recommend creating a streaming video format with three variants that use the following HLS specifications.

We recommend using the H.264 codec for video variants, the AAC-LC codec for audio variants, and the .ts filename extension.

Recommended non-streaming formats

We recommend generating embed links to the following non-streaming video formats:

• For third-party tools or social platforms that don’t support streaming, we recommend the following settings:
  • Height: 1080p
  • Width: 1920p
  • Filename extension: .mp4
  • Video bitrate: 5000
• For manual downloads, such as when creative teams need the highest resolution web-ready version, we recommend the following settings:
  • Height: 1440p
  • Width: 2560p
  • Filename extension: .mp4
  • Video bitrate: 9000

Public embed links

By default, each embed link uses the following base URL:

https://[cdncontent-delivery-network-domain].com/AssetLink]/[RandomString].[FileExtension]

In this URL:

• [cdn-domain] is the domain of the content delivery network (CDN) your organization uses to deliver content to external audiences. This is an Orange Logic-managed domain by default, but your organization can serve assets from your own domain instead — for example, media.yourbrand.com.
• [AssetLink] is a plain text string.
• [RandomString] is a randomly-generated, unique identifier used to ensure the URL to this format is unique.
• [FileExtension] is the filename extension that determines the delivery method in the web browser.

The following link is an example:

https://mangovations-cdn.orangelogic.com/AssetLink/742rm0ik1qt44o567b72u7e5v6451a20.mp4

📘

Note

Administrators can set up format policies to automatically generate links with a different URL.

Generate custom embed links

You can generate public embed links for up to 10,000 records. You can customize the URL path and configure the asset format, expiration date, size, file extension, and more. You can also generate transformations to crop, resize, and rotate images as well as strip or preserve metadata and adjust image quality. These links are distributed through a CDN. These links also appear in the Embed Links extension in the Orange Logic interface.

Additional link options

The public embed link API is the recommended approach to generating public links for distribution.

There are several other options to generate asset links:

• Get public links: Generate public embed embed links distributed through a CDN. You cannot customize the URL path with the get-link APIs.
• Get an asset’s cloud storage link APIs: If you don’t want to generate a public link to an asset, you can generate a direct link to the asset in its cloud storage. For example, suppose you are building an integration between Orange Logic and another system. You want the assets to be shared with the third-party system, but you don’t need to embed the asset or make it visible to external users. In this case, you can generate a link to the asset in its cloud storage location.
• Generate public Share links: Generate expirable, secure links to assets or folders to share with users. You can choose to grant download permission or apply watermarks.
• Create crop link API: This option is a legacy endpoint that allows you to create a public link to a cropped version of an asset. This API has fine-grained parameters, allowing you to crop at the exact position of an image. The public. link APIs described above uses an ImageResizingMethod parameter that can only crop an image from a direction (north, northwest, etc.) or fit or stretch the image to fit a dimension.