Configuring Image Transcoding in the Portal
If you have the V2 config framework, this document is superseded by Configuring SmartVision Image Transcoding with the Performance & Delivery Rule Builder.
There are two sections to this page: SmartVision Configuration, which is for SmartVision Transcoding settings for the entire property, and Exceptions, which is for overriding some of the SmartVision settings in specific domains and/or in specific paths in domains.
Image Transcoding with SmartVision is described in this document.
SmartVision Transcoding Configuration
To the right of the label Advanced SmartVision Transcoding Settings is a pair of radio buttons that allow you to turn SmartVision ON or OFF by default for the entire property. If you click the ON radio button, you will also see controls for Profile and Advanced Image Formats:
These can be individually disabled for either JPGs or PNGs with the toggle button on the left.
Profile is a slider that allows you to choose how the transcoding feature is applied to images. The choices are
- Lossless: with this setting images will not lose any quality and the file size benefit of Image Transcoding is minimal
- Safe: sets the safe quality profile for SmartVision. Choosing this or either of the next two profiles offers a tradeoff between the size of the transcoded images and the quality of experience. This value to used when a customer wants to have minimal impact to image quality, but results in a smaller byte reduction
- Standard: this is middle ground between safe and aggressive. This results in a small impact to quality with a better chance of byte reduction. This is the default value.
- Aggressive: this results in a maximal byte reduction but will potentially have a visible impact on image quality for some images.
- Manual: this allows you to override SmartVision with a single quality level that will be applied in transcoding all JPG and PNG images.
Advanced Image Formats is a series of radio buttons that let you control whether or not JPG and PNG images will be transcoded to WebP or JPEG XR images when the requesting browser is Google Chrome (for WebP) or Microsoft Internet Explorer 10.0 and above or Microsoft Edge (for JPEG XR). You can choose Enabled for both, WebP-only, JPEG XR-only, or Disabled for neither.
Once you have adjusted the desired parameters, click Save Settings.
Under Exceptions are displayed Property Exceptions , followed by Domain and Path Exceptions (if any).
Exceptions at the property level allows you to create some very specific actions that depend on conditions other than in which domain and path, using expressions to test for those conditions; when the expressions match, the action is taken. The current release of the Portal does not support editing of domains and paths that include such rules. Please contact Support if you want to have further control over caching settings than currently allowed by the Portal.
The Domain and Path Exceptions section displays a list of any exceptions that have already been defined (if any). By default it displays domain exception only; to see any property exceptions within a domain, click the right arrow icon to expand it:
Creating a new exception
To create a new exception, click the Add New Exception button. This will open a Create Exception form:
In step 1, you choose an existing domain. You can also choose an existing path pattern from the pulldown, or enter a new one in the Edit Patterns field to the right, then click the Add Path button beneath the field to add it. You can repeat this action for as many paths as you need to have in this exception.
When ready, click the Next: Create Exceptions button. This takes you to step 2, where you can turn SmartVision on or off, set the Profile, and select Advanced Image Formats settings for images in this path. (The choices are the same as described above for overall settings at the property level.) You can also go back to step 1 if needed by clicking Edit Domain/Path (Cancel will cancel the entire exception creation process, not the current step).
When ready, click Next: Review Exception. This takes you to step 3, where you can check that everything is as desired. If so, click Create Exception:
The portal will acknowledge that your configuration update request has been submitted by displaying a temporary message like this near the top of the window:
At the same time, the Running Tasks icon displays a number (this is the number of tasks currently running). If you hover the mouse pointer over the icon, a task message will be displayed:
Editing an existing exception
To edit a domain exception, click on the Edit button to the right.
To edit a path exception within a specific domain, first click on the expand button icon at the left of the domain. This displays all the paths within this domain and any exceptions that currently exist:
You cannot edit existing paths in exceptions, only add new ones.
Choose the path you want to edit and click the Edit button to its right. This will open a form to edit the exception:
Here you can turn SmartVision on or off, set the Profile, and select Advanced Image Formats settings for images in this path. (The choices are the same as described above for overall settings at the property level.)
You cannot currently modify paths in exceptions.
When ready, click Next: Review Exception. This takes you to step 3, where you can check that everything is as desired. If so, click Create Exception.
As with adding a new rule, the portal will acknowledge that your configuration update request has been submitted by displaying a temporary message near the top of the window and the Running Tasks icon displays a number (this is the number of tasks currently running). If you hover the mouse pointer over the icon, a task message will be displayed to the effect that the configuration is being updated.
Deleting an existing exception
To delete a path exception, click on the red Delete button to the right: