Support for Remote Assets remote-assets-support

Learn how to configure the Core Component Image and Teaser Components to support remote assets using Dynamic Media with OpenAPI.

Dynamic Media with OpenAPI was formerly known as Next Generation Dynamic Media. The functionality and usage is identical.

Get the Latest AEM Version latest

Support for remote assets using Dynamic Media with OpenAPI requires:

  • AEM 6.5 SP 18+ or AEM as a Cloud Service
  • Core Components release 2.23.2 or later

Configure HTTPS https

It is generally recommended to run all of your production AEM instances using HTTPs. However your local development environments may not be set up as such. However, remote assets using Dynamic Media with OpenAPI requires HTTPS in order to function.

Use this guide to configure HTTPS wherever you wish to use remote assets, including development environments.

Configure OSGi osgi

The location of the remote assets must be defined in an OSGi configuration. Configure the Next Generation Dynamic Media Config OSGi configuration as follows, replacing the values with those of your remote asset environment.


The Next Generation Dynamic Media Config OSGi configuration window

For details on how to configure OSGi, please see the following documents:

Verify Configuration verify

Now you can verify that the remote assets feature using Dynamic Media with OpenAPI is working. To do this, you can install the WKND sample site and Core Components.

Once the Core Components and WKND site are installed, you can test the feature on any WKND page.

  1. Access the AEM instance using HTTPS.

  2. Open a WKND demo page in the page editor such as https://<host>:<httpsPort>/editor.html/content/wknd/language-masters/en/magazine/arctic-surfing.html

  3. Add an image component to the page.

  4. In the Configure dialog of the component, uncheck the option Inherit featured image from page on the Asset tab and click Pick.

  5. If the configuration is correct, a drop-down will appear with the options Local and Remote. Select Remote.

    Remote and local pick options for image selection

  6. A dialog will open and you will need to authenticate to the remote service.

  7. Once authenticated, an asset browser of the remote service will open. Select the desired asset and tap or click Select.

    Selecting a remote asset

The remote asset is added to your local AEM page and you have verified that the feature is correctly configured.

Using Remote Assets using

Once configured, remote assets can be selected where you would select assets using the Core Components such as in the Image Component and the Teaser Component.