Adding and editing images

A web page does not embed images, instead it links to the media library where images are stored. To display images in your content, the images must be available in a folder under Media in the assets pane. You can either first upload an image to a folder in the assets pane, and then add it to your content, or you can drag and drop an image directly from your computer to a content area. In this latter case, the image is automatically uploaded and stored in the For This Page (or For This Block) folder.

You can edit images inside Optimizely using the Image Editor, providing basic image editing features such as cropping, resizing and transforming.

Adding images to content

In image link property

Images are often added to content through an image link property. You can either drag and drop an image from the assets pane or from your computer to the property. If you drag and drop from your computer, the image is automatically uploaded and saved in the For this Page or For this Block folder in the assets pane. See Media for information on how to manually upload images to the assets pane.

To replace an already added image, click the image and the Select Image dialog box opens. In this dialog you can select another already uploaded image or upload a new image. You can also replace the current image by simply dragging and dropping another image into the image property.

Image: Image link property

Image: Select Image dialog box

In rich-text editor or content areas

You can also add images to the rich-text editor or content areas in pages or blocks. To add an image this way, you can drag and drop the image directly from your computer into the rich-text editor. The image is automatically stored in the For This Page (or For This Block) folder with its original file name. Another way is to first upload the image to a folder under Media in the assets pane and then add the image through drag and drop from the folder, or by using the Insert/edit image Image: Insert/edit media button button on the toolbar in the rich-text editor.

  1. Place the cursor in the editor area where you want the image.
  2. Click the Insert/edit image button on the editor toolbar.
  3. Select the desired image in the Source folder structure.
  4. Enter an Image description for the image. It is added as an HTML <a> tag to the image and this is important when a reader has turned off the display of images in the browser or when a visually impaired user is using a screen reader.
  5. Click Ok.

The TinyMCE editor supports the following image formats: jpeg, png, gif, and bmp.

Aligning images

You can align images so that they are aligned to, for example, the right and the text wraps around the image to the left:

Image: Image aligned right in content area

  1. Place the cursor at the end of the text you want to wrap around the image.
  2. Drag and drop the image onto this location.
  3. Select the image.
  4. On the editor toolbar, select Format > Align > Right:
    Image: Aligning images using the Format Align option on toolbar

Finding the image location

If you have an already inserted image in the rich-text editor and you want to find out where it is stored, select the image and a Go to media button is displayed. Click this button to open the image or hover over it to see where the image is stored.

Image: Finding an image's location

Editing images

Do one of the following to access the Image Editor options:

  • In an image link property, click in the image property to open the Select Image dialog box, and select Open in Image Editor from the image's context menu:

    Image: Context menu, Open in Image Editor

  • In the rich-text editor, select the image and then click Image Editor in the toolbar.

    Image: Image toolbar

  • Locate the image under Media in the assets pane, and select Open in Image Editor from the context menu.

    Image: open media in Image editor

Image editing features include cropping, resizing and transforming:

Image editing Description
Crop Enter values for Top, Left, Width and Height, or draw a selection in the image to crop.

Remember to click Apply to save the changes before proceeding.

You can apply Preset values if such values have been configured for the website.
Resize Enter values for Width and Height, or move a corner handle to resize, keep Constrain proportions selected to retain the image proportions.

Remember to click Apply to save the changes before proceeding.

You can apply Preset values if such values have been configured for the website.
Transform Flip or rotate the image, or select Grayscale to convert to grayscale.

You can save an edited image file as a copy, or replace the original file:

  • Save as a copy. If the image was selected in a page or block, the copy is saved in the local folder. If the edited image was selected in the media structure, the (renamed) copy is saved in the same folder as the original.
  • Replace original image. This action affects places on the website where the image is used.

Selecting the Edit option in the context menu for an image lets you edit the metadata, which for an image can be photographer, description and copyright information and such. See Media.

Removing images from content

For an image in:

  • an image property, click Remove Optimizely image.
  • a content area, select Remove in the context menu.
  • the rich-text editor, click the image and delete it.

Removing an image makes it disappear from the content, but it remains in Media.