Smart Imaging smart-imaging

No. Smart Imaging is included with your existing license. This rule is true for either Dynamic Media Classic or Experience Manager - Dynamic Media (On-prem, AMS, and Experience Manager as a Cloud Service).

note important
IMPORTANT
Smart Imaging is not available to Dynamic Media - Hybrid customers.

Yes. You can turn off Smart Imaging by adding any of the following modifiers:

• bfc=off to turn off Browser Format Conversion. See also Browser Format Conversion.
• dpr=off to turn off Device Pixel Ratio. See also Device Pixel Ratio.
• network=off to turn off network bandwidth. See also Network Bandwidth.

Yes. Smart Imaging has three options that you can enable or disable.

• Browser Format Conversion
• Device Pixel Ratio
• Network Bandwidth

Smart Imaging seamlessly integrates with your existing image presets, respecting all your image settings.

The only adjustments involve the image format, or quality, or both. During format conversion, Smart Imaging preserves full visual fidelity according to your preset settings but delivers a smaller file size. Just enable it by adding bfc=on, or dpr=on,dprValue, or network=on, or all three parameter settings to your existing URLs or presets.

For example, let’s say an image preset specifies a JPEG format at 500 × 500 pixels, with quality=85, and unsharp mask=0.1,1,5. Smart Imaging detects if the user is on a Chrome browser. It then converts the image to WebP with the same dimensions (500 × 500) and an unsharp mask matching the JPEG’s settings. The system then compares the file sizes of the WebP and JPEG versions and serves the smaller one to the user.

Yes, to both questions. Smart Imaging works with images delivered over HTTP or HTTPS. In addition, it also works over HTTP/2.

Smart Imaging is ready to use immediately for all customers. To start enjoying its benefits, just add bfc=on, or dpr=on,dprValue, or network=on, or all three parameter settings to your existing URLs or presets.

To activate Smart Imaging, your company’s Dynamic Media Classic or Dynamic Media on Experience Manager account must include the Adobe bundled CDN (Content Delivery Network) as part of your license.

To start using Smart Imaging, append bfc=on, or dpr=on,dprValue, or network=on, or all three parameter settings to your existing URLs or presets. If you prefer not to make these changes manually, you can enable Smart Imaging by default by creating a support case.

When creating the support case, specify which Smart Imaging features you want activated on your account:

• Browser Format Conversion (WebP or AVIF)
• Network Bandwidth Optimization

note note
NOTE
DPR requires client-side adjustments to determine the correct dprValue. Therefore, Adobe recommends enabling DPR through URLs by appending dpr=on,dprValue.

To create a support case to enable Smart Imaging on your account:

1. Use the Admin Console to start the creation of a new support case.

2. Provide the following information in your support case:

   • Primary contact details:

     • Provide your name, email, and phone number.

   • Smart Imaging features to enable:

     • List the capabilities that you want for your account:

       • Browser format conversion: WebP or AVIF
       • Network bandwidth optimization
       • DPR: DPR requires client-side adjustments to determine the correct dprValue. Therefore, Adobe recommends enabling DPR through URLs by appending dpr=on,dprValue.

   • Domain for Smart Imaging:

     • List all relevant domains, such as company.com or mycompany.scene7.com

     • Smart Imaging supports both generic and custom domains.

     • To identify your domains, open the Dynamic Media Classic desktop application and sign in to your company account.

       1. Navigate to Setup > Application Setup > General Settings.
       2. Look for the Published Server Name field to confirm your domain.
       3. Verify that you are using Adobe’s CDN rather than one managed by another provider.

   • Indicate HTTP/2 support:

     • Specify if you need Smart Imaging to work over HTTP/2.

3. Adobe Customer Support enables the requested Smart Imaging features by default, eliminating the need to append parameters manually to URLs.

4. Adobe recommends setting the Time To Live (TTL) to at least 24 hours to maximize performance through caching.
   To adjust the TTL:

   1. For Dynamic Media Classic:

      1. Navigate to Setup > Application Setup > Publish Setup > Image Server.
      2. Set the Default Client Cache Time To Live value to 24 hours or more.

   2. For Dynamic Media on Adobe Experience Manager:

      1. Follow these instructions.
      2. Set the Expiration value for 24 hours or more.

Customer Support processes requests in the order that they receive them, following the Wait List.

note note
NOTE
There can be a long lead time because enabling Smart Imaging involves Adobe clearing the cache. Therefore, only a few customer transitions can be handled at any given time.

There is no risk to a customer web page. However, the transition to Smart Imaging does clear out your CDN cache. This operation involves moving to a new configuration of Dynamic Media Classic or Dynamic Media on Experience Manager.

During the initial transition, the non-cached images directly hit Adobe’s origin servers until the cache is rebuilt again. As such, Adobe plans to handle a few customer transitions at a time so that acceptable performance is maintained when pulling requests from the origin. For most customers, the cache is fully built up again at the CDN within about one to two days.

Yes. You can do the following:

1. After your account is configured with Smart Imaging, load a Dynamic Media Classic or Adobe Experience Manager - Dynamic Media image URL in the browser.

2. Open the Chrome developer pane by going to View > Developer > Developer Tools in the browser. Or, choose any browser developer tool of your choice.

3. Ensure that the cache is disabled when developer tools are open.

   • On Windows®, navigate to settings in the developer tool pane, then select Disable cache (while devtools is open) check box.
   • On macOS, in the Developer pane, under the Network tab, select disable cache.

4. Observe the Content Type is transformed to the appropriate format. The following screenshot shows a PNG image being converted dynamically to WebP on Chrome. If your domain has AVIF enabled, you can also expect to see AVIF in the Content Type.

5. Repeat this test on different browsers and user conditions.

note note
NOTE
Not all images are converted. Smart Imaging decides if the conversion can improve performance. Sometimes, where there is no expected performance gain or the format is not JPEG or PNG, the image is not converted.

Yes. The Smart Imaging Header determines the benefits of Smart Imaging. When Smart Imaging is enabled, after you request an image, under the Response Headers heading, you can see -X-Adobe-Smart-Imaging as seen in the following highlighted example:

This header tells you the following:

• Smart Imaging is working for the company.
• A positive value means that the conversion is successful. In this case, a new WebP image is returned.
• A negative value means that the conversion is not successful. In such case, the original requested image is returned (JPEG by default, if not specified).
• A positive value shows the difference in bytes between the requested image and the new image. In the example above, the bytes saved is 75048 or approximately 75 KB for one image.
• A negative value means that the requested image is smaller than the new image. The negative size difference is shown, but the image served is the original requested image only.

note note
NOTE
X-Adobe-Smart-Imaging = -1 with WebP being delivered
If the value of X-Adobe-Smart-Imaging is -1 and WebP is still being delivered, Smart Imaging is active. However, the size benefits were not calculated because of outdated cache. You can use cache=update (one time only) in the image’s URL to fix this issue. An example of using the modifier: https://smartimaging.scene7.com/is/image/SmartImaging/sample1?cache=update To invalidate the entire cache, you must create a support case.

Yes. If you want to switch back to serving WebP by default, create a support case for the same. As usual, you can turn off Smart Imaging by adding the parameter bfc=off to the image’s URL. However, you cannot select WebP or AVIF in the URL modifier for Smart Imaging. This ability is maintained at your company account-level.

This error does not occur if Smart Imaging is not enabled on your account. Smart Imaging works with either JPEG or PNG formats only.

To avoid this error, you can either:

• Specify JPEG or PNG, or
• Not use the fmt modifier at all, or
• Use a browser-preferred format defined by Smart Imaging. For example, you can use WebP for the Chrome Web browser.

Yes. Add fmt=tif and bfc=off to image’s URL path.

Yes. Smart Imaging uses both format and quality. The rest of the parameters remain the same, if requested in the image’s URL.

No. Currently there is no such provisioning.

Yes. Smart Imaging automatically adjusts the quality percent. This quality is determined using a machine learning algorithm developed by Adobe. This percent is not range-specific.

Yes. This functionality works for JPEG and PNG only.

Smart Imaging determines if the conversion is beneficial or not. It returns the new image only of the conversion is beneficial.

If a composite image involves too many layers, dpr functionality may be impacted while using a position modifier. This issue is known and will be fixed in future releases of Smart Imaging. If other Smart Imaging functionality is not working as expected, you can create a support case to report the issue.

Because PNG is a lossless format, earlier WebP and AVIF being delivered were lossless, resulting is higher size than expected. Smart Imaging now supports lossy conversion. You can use the modifier cache=update (one time only) in an image request to fix this issue. An example of using this modifier:

https://smartimaging.scene7.com/is/image/SmartImaging/sample1?cache=update

To invalidate the entire cache, you must create a support case requesting such effort.

Yes. Smart Imaging now supports lossy conversion based on the quality level. You can continue using lossless conversion by setting the quality to 100, either through your company’s settings, or by adding qlt=100 to the image’s URL path.