--- title: Add and edit images slug: cms-13/docs/add-and-edit-images docTags: createdAt: 2026-07-30T20:22:11.023Z --- Webpages link to images stored in the media library rather than embedding them directly. Images must be available in a folder under **Media** in the assets pane to display in your content. Upload an image to a folder in the assets pane and then add it to your content, or drag and drop an image from your computer to a content area. When you drag and drop, the image uploads automatically and is stored in the **For This Page** (or **For This Block**) folder. Edit images directly in Optimizely Content Management System (CMS 13) using the image editor, which provides cropping, resizing, and transformation features. ## Add images to content Add images to your content through image link properties, the rich-text editor, or content areas. ### Image link property Add images to content through an image link property by dragging an image from the assets pane or your computer to the property. If you drag and drop from your computer, the image uploads automatically and is saved in the **For this Page** or **For this Block** folder in the assets pane. See [Media](docId\:rkqtmEpdz-rZoJJvRInYk) for information on uploading images to the assets pane. ![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/dDbzyW70vDlQOlZOM4Sz9_82ed1ac44d0aabe65248551d8c416132cea223810dfb797fa9e7aedd4607317e-image.png) ![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/NGS3X6JXL5nRrd7nKm_x1_4b54239453cde10332d7ef3d7ee8ebfe79f5149ee1449a6a868c471434e6235b-image.png) To replace an already added image, drag and drop another image into the image property or click the image and select another image in the **Select Image** window. ![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/Z4dqxuosIYqXlh9p71RJY_3acc822ea1362a1d458a7e93b78650942728172503e13be57e82a737ca69f096-image.png) ### Rich-text editor or content areas Add images to the rich-text editor or content areas in pages or blocks. Drag and drop the image from your computer into the rich-text editor. The image is stored automatically in the **For This Page** (or **For This Block**) folder with its original file name. Alternatively, [upload the image](docId\:rkqtmEpdz-rZoJJvRInYk) to a folder under **Media** in the assets pane and then drag it from the folder or use the **Insert/edit image** option in the rich-text editor. 1. Place the cursor in the editor area where you want the image. 2. Click **Insert/edit image**. ![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/yQxGLTXpYDZ8zpvz6hwlW_6618f326383de6fe801f628329b2c7b93344ca6327e1d3b120d16eb1117316d8-image.png) 3. Click **Browse files** next to the **Source** field and select the desired image. ![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/UvmOh48i21CUQfaj52AVg_2ba3fb786da526e1f282356856cae7a42a185d1ca52ac9d427837383a2280fe3-image.png) 4. (Optional) Enter an **Alternative description** for the image, which gets added as an HTML `` tag to the image. 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 **Save**. :::hint{type="info"} **Note** The TinyMCE editor supports the following image formats: `jpeg`, `png`, `gif`, and `bmp`. ::: ## Find image location Locate the storage path of an image that is already in the rich-text editor. Select the image and hover over **Go to media**. ![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/BYt1GtYHJaVDNSX1d3zf3_a574e49d1701752a2698d7e6c33ca2af4f00f8de8a96fe52448904e7e65a10b1-image.png) ## Edit image metadata View and edit the metadata for an image, including the image name, content ID, and copyright information. Access an image's metadata using one of the following methods: - In an image link property, click in the image to open the **Select Image** window, and then click **More (...) > Edit** for the image. ![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/V9ncG2uXhzOFL23MaI71L_cdc97812bb9bdbaeb4f99b838c6ebe2f1b942a669eec7feb18f9b4c0412a20b5-image.png) - In the rich-text editor, select the image and then click **Go to media**. ![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/etN0RMNuZh0Ty7s_Rm8yF_d9fc8b5578c34f3628b25010617efccbaaf46f59e4b840e61e3178940ae474dc-image.png) - In the **Media** tab of the assets pane, click **More (...) > Edit** for the image you want to edit. ![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/jIbTi-aFHOWNBcEtZDli6_1709376647ccccb52107ac2f0a60b67995307ee329a59a8e3cc672bc29d15a83-image.png) ## Edit images Use the **Image Editor** in CMS 13 to [crop](docId:-o0gg-XGmAGQTjS2zdPc8), [resize](docId:-o0gg-XGmAGQTjS2zdPc8), and [transform](docId:-o0gg-XGmAGQTjS2zdPc8) an image. Access the **Image Editor** using one of the following methods: - In an image link property, click in the image to open the **Select Image** window, and then click **More (...) > Open in Image Editor** for the image. ![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/0eFp9NnO9j4eMoBdmB7if_eda156a93f2a271cb2fb639e9b218718f225f94e77eae593dd2dfbc5a4163640-image.png) - In the rich-text editor, select the image and then click **Image Editor** in the toolbar. ![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/78oswmaVwfwHFyLFsgNGM_a8069a741cc8b34693ad96402032c33854ea195549c3dbb5a9641263e7f997f0-image.png) - In the **Media** tab of the assets pane, click **More (...) > Open in Image Editor** for the image you want to edit. ![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/7USOCMuTVTZQQ_jBv_d7g_a70e44cc675135e3c35adc794fefea2a32a23e87231bfc2a327a8f51034edfe3-image.png) ### Crop 1. Select **Crop** in the **Image Editor**. 2. Enter values for **Top**, **Left**, **Width**, and **Height**, or draw a selection in the image to crop. You can also apply **Preset** values if such values are configured for the website. 3. Click **Apply** to save the changes before proceeding. 4. Continue editing the image as desired, and then [save your changes](docId:-o0gg-XGmAGQTjS2zdPc8). ![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/lPqCEL2ao7eZ5XbHzHatr_a9288b3aa1adc664454658b72fb4e048c7cf133218b6bf219218ab40fd2ea346-image.png) ### Resize 1. Select **Resize** in the **Image Editor**. 2. Enter values for **Width** and **Height**. You can also apply **Preset** values if such values are configured for the website. :::hint{type="info"} **Note** **Constrain proportions** is selected by default to retain the image proportions as you resize. ::: 3. Click **Apply** to save the changes before proceeding. 4. Continue editing the image as desired, and then [save your changes](docId:-o0gg-XGmAGQTjS2zdPc8). ![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/zhoYAbnARTcO11ud_surz_c7e9e45846f8445ef5120291b4cbc4dbf208a1e196ccc61e4bafbe31388502d7-image.png) ### Transform 1. Select **Transform** in the **Image Editor**. 2. Rotate or flip the image as desired. 3. (Optional) Select **Grayscale** to convert the image to grayscale. 4. Continue editing the image as desired, and then [save your changes](docId:-o0gg-XGmAGQTjS2zdPc8). ![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/OqIhtvpY-pWbZs01R-yra_c10883f74b8fbeb6a082c08ba27513a7bd09c057fbd813603df798de64d886b1-image.png) ### Save as copy or replace the original Save an edited image file as a copy or replace the original file: - **Save as a copy** – If you selected the image on a page or block, the copy is saved in the **local folder**. If you selected the edited image in the media structure, the renamed copy is saved in the same folder as the original. - **Replace original image** – This action affects all places on the website where the image is used. Select the **Quality** for the image before saving. ![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/3Y3Lcw1-NNibtR-rS9pmJ_ebe53e5380630c0536abbe3a466e95746a5b86c2bdcab4bab755bc91a7afc13d-image.png) ### Alt text in CMS images The site developer handles alt text. ## Remove images from content Remove an image from the content to hide it from visitors. The image remains in **Media** for future use. Use one of the following methods to remove an image: - In an image link property, click **More (...) > Remove** for the image. ![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/pnsR0tptELI4U4wzkE-vq_1c38603be6110204fd4c6ea54f251be14513f058b45c7d80386cf18fbfadd5b3-image.png) - In a content area, click **Close (x)** for the image. ![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/mAv3S_yfLJ-A2dOdohQPK_0700c3010cb67fe4ca6da4defc824145789257f246bfed0c903cc33c052e1a49-image.png) - In the rich-text editor, select the image or place your cursor after the image and delete it. ![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/jWfpYJqmoUD6kT1QUG7ky_6f58269ddcdd53c0ca2699a8b826bf6fc04d4d4399307f55ac58ef841b46dbf3-image.png)