Contextual editing for images

Contextual editing allows you to take image assets within Brightspot and give them a unique appearance for specific assets without modifying the original image asset. In order to use contextual image editing, the @ToolUi.ContextualImageEditing annotation must be applied to the field, and changes are required to be made to the appropriate view model to apply the metadata override; therefore, this feature requires assistance from a developer to enable.

In the table above, there are two versions of the same image. The original image is on the left, while the one with contextual edits is on the right. The image on the left is the image that is stored in Brightspot as an image asset. This image asset can be used and reused as it appears on the left. Any changes you make to that image automatically cascade to every asset using it.

The image on the right is that same image asset placed in the Lead field within an article. Within this article, the image has had contextual edits applied. This image displays with the sepia effect only in this article. Anywhere else this image is used, it looks like the original on the left. Furthermore, any changes to the original image do not cascade to this image in the article.

To contextually edit an image in an asset:

1. After adding an image to an asset in Brightspot, click brush in the upper-right corner of the image to open the .
   

   

2. In the , add any effects, edits, etc. to the image that you want to display within the asset where the image is placed.
3. When finished, click Done to be returned to the original asset where you added this image.
   

   

4. Complete your site's workflow and publish the asset.

When published, the asset that contains this image will display it with the edits you made, but not affect the original image asset.