Panoramic Images panoramic-images

AEM 6.4 has reached the end of extended support and this documentation is no longer updated. For further details, see our technical support periods. Find the supported versions here.

This section describes working with the Panoramic Image viewer to render spherical panoramic images for an immersive 360° viewing experience of a room, property, location, or landscape.

See also Managing Viewer Presets.


Uploading assets for use with the Panoramic Image viewer uploading-assets-for-use-with-the-panoramic-image-viewer

For an uploaded asset to qualify as a spherical panorama image that you intend to use with the Panoramic Image viewer, the asset must have either one or both of the following:

  • An aspect ratio of 2.

    You can override the default aspect ratio setting of 2 in CRXDE Lite at the following:


  • Tagged with the keywords equirectangular, or sphericaland panorama, or spherical and panoramic. See Using Tags.

Both the aspect ratio and keyword criteria apply to panoramic assets for the asset details page and the Panoramic Media component.

To upload assets for use with the Panoramic Image viewer, see Uploading Assets.

Configuring Dynamic Media Classic configuring-dynamic-media-classic-scene

For the Panoramic Image viewer to work properly within AEM, you must synchronize the Panoramic Image viewer presets with Dynamic Media Classic and Dynamic Media Classic–specific metadata so the viewer presets get updated in the JCR. To accomplish this, configure Dynamic Media Classic in the following manner:

  1. Sign in to your Dynamic Media Classic desktop application for each company account.

  2. Near the upper-right corner of the page, click Setup > Application Setup > Publish Setup > Image Server.

  3. On the Image Server Publish page, from the Publish Context drop-down menu near the top, select Image Serving.

  4. On the same Image Server Publish page, locate the heading Request Attributes.

  5. Under the Request Attributes heading, locate Reply Image Size Limit. Then, in the associated Width and Height fields, increase the maximum allowable image size for panoramic images.

    Dynamic Media Classic has a limit of 25,000,000 pixels. The maximum allowable size for images with a 2:1 aspect ratio is 7000 x 3500. However, for typical desktop screens, 4096 x 2048 pixels is sufficient.

    note note
    Only images that fall within the maximum allowable image size are supported. Requests for images that are above the size limit will result in a 403 response.
  6. Under the [Request Attributes] heading, do the following:

    • Set Request Obfuscation Mode to Disabled.
    • Set Request Locking Mode to Disabled.

    These settings are necessary for using the Panoramic Media component in AEM.

  7. At the bottom of the Image Server Publish page, on the left side, tap Save.

  8. In the lower-right corner, tap Close.

Troubleshooting the Panoramic Media component troubleshooting-the-panoramic-media-wcm-component

If you dropped an image into the Panoramic Media component in your WCM and the component placeholder collapsed, you may want to troubleshoot the following:

  • If you experience a 403 Forbidden error, it may have been caused by the requested image size being too large. Review the Reply Image Size Limit settings in Configuring Dynamic Media Classic.

  • For an Invalid lock on the asset or Parsing error displayed on the page, check Request Obfuscation Mode and Request Locking Mode to ensure they are disabled.

  • For a tainted canvas error, setup a Rule Set Definition File Path and Invalidate CTN for the previous requests for the image asset.

  • If image quality becomes very low after an image request with sizing above the supported limit, check that the JPEG Encoding Attributes > Quality setting is not empty. A typical setting for the Quality field is 95. You can find the setting on the Image Server Publish page. To access the page, see Configuring Dynamic Media Classic.

Previewing Panoramic Images previewing-panoramic-images

See Previewing Assets.

Publishing Panoramic Images publishing-panoramic-images

See Publishing Assets.