# Insert images

In Document Editor, you can insert images in the most popular formats into your document. The following image formats are supported: BMP, GIF, JPEG, JPG, PNG.

### Insert an image

To insert an image into the document text,

1. place the cursor where you want the image to be put,
2. switch to the Insert tab of the top toolbar,
3. click the Image icon at the top toolbar,
4. select one of the following options to load the image:
   - the Image from File option will open the standard dialog window for file selection. Browse your computer hard disk drive for the necessary file and click the Open button
   - the Image from URL option will open the window where you can enter the necessary image web address and click the OK button
   - the Image from Storage option will open the Select data source window. Select an image stored on your portal and click the OK button
5. once the image is added you can change its size, properties, and position.

### Move and resize images

To change the image size, drag small squares situated on its edges. To maintain the original proportions of the selected image while resizing, hold down the Shift key and drag one of the corner icons.

To alter the image position, use the icon that appears after hovering your mouse cursor over the image. Drag the image to the necessary position without releasing the mouse button.

When you move the image, guide lines are displayed to help you position the object on the page precisely (if a wrapping style other than inline is selected).

To rotate the image, hover the mouse cursor over the rotation handle and drag it clockwise or counterclockwise. To constrain the rotation angle to 15 degree increments, hold down the Shift key while rotating.

Note: the list of keyboard shortcuts that can be used when working with objects is available here.

### Adjust image settings

Some of the image settings can be altered using the Image settings tab of the right sidebar. To activate it click the image and choose the Image settings icon on the right. Here you can change the following properties:

- Size is used to view the current image Width and Height. If necessary, you can restore the default image size clicking the Default Size button. The Fit to Margin button allows to resize the image, so that it occupies all the space between the left and right page margin.

  The Crop button is used to crop the image. Click the Crop button to activate cropping handles which appear on the image corners and in the center of each its side. Manually drag the handles to set the cropping area. You can move the mouse cursor over the cropping area border so that it turns into the icon and drag the area.

  - To crop a single side, drag the handle located in the center of this side.
  - To simultaneously crop two adjacent sides, drag one of the corner handles.
  - To equally crop two opposite sides of the image, hold down the Ctrl key when dragging the handle in the center of one of these sides.
  - To equally crop all sides of the image, hold down the Ctrl key when dragging any of the corner handles.

  When the cropping area is specified, click the Crop button once again, or press the Esc key, or click anywhere outside of the cropping area to apply the changes.

  After the cropping area is selected, it's also possible to use the Fill and Fit options available from the Crop drop-down menu. Click the Crop button once again and select the option you need:

  - If you select the Fill option, the central part of the original image will be preserved and used to fill the selected cropping area, while other parts of the image will be removed.
  - If you select the Fit option, the image will be resized so that it fits the cropping area height or width. No parts of the original image will be removed, but empty spaces may appear within the selected cropping area.
- Rotation is used to rotate the image by 90 degrees clockwise or counterclockwise as well as to flip the image horizontally or vertically. Click one of the buttons:
  - to rotate the image by 90 degrees counterclockwise
  - to rotate the image by 90 degrees clockwise
  - to flip the image horizontally (left to right)
  - to flip the image vertically (upside down)
- Wrapping Style is used to select a text wrapping style from the available ones - inline, square, tight, through, top and bottom, in front, behind (for more information see the advanced settings description below).
- Replace Image is used to replace the current image loading another one From File or From URL.

Some of these options you can also find in the right-click menu. The menu options are:

- Cut, Copy, Paste - standard options which are used to cut or copy a selected text/object and paste a previously cut/copied text passage or object to the current cursor position.
- Arrange is used to bring the selected image to foreground, send to background, move forward or backward as well as group or ungroup images to perform operations with several of them at once. To learn more on how to arrange objects you can refer to this page.
- Align is used to align the image left, center, right, top, middle, bottom. To learn more on how to align objects you can refer to this page.
- Wrapping Style is used to select a text wrapping style from the available ones - inline, square, tight, through, top and bottom, in front, behind - or edit the wrap boundary. The Edit Wrap Boundary option is available only if you select a wrapping style other than Inline. Drag wrap points to customize the boundary. To create a new wrap point, click anywhere on the red line and drag it to the necessary position.
- Rotate is used to rotate the image by 90 degrees clockwise or counterclockwise as well as to flip the image horizontally or vertically.
- Crop is used to apply one of the cropping options: Crop, Fill or Fit. Select the Crop option from the submenu, then drag the cropping handles to set the cropping area, and click one of these three options from the submenu once again to apply the changes.
- Default Size is used to change the current image size to the default one.
- Replace image is used to replace the current image loading another one From File or From URL.
- Image Advanced Settings is used to open the 'Image - Advanced Settings' window.

When the image is selected, the Shape settings icon is also available on the right. You can click this icon to open the Shape settings tab at the right sidebar and adjust the shape Stroke type, size and color as well as change the shape type selecting another shape from the Change Autoshape menu. The shape of the image will change correspondingly.

To change the image advanced settings, click the image with the right mouse button and select the Image Advanced Settings option from the right-click menu or just click the Show advanced settings link at the right sidebar. The image properties window will open:

The Size tab contains the following parameters:

- Width and Height - use these options to change the image width and/or height. If the Constant proportions button is clicked (in this case it looks like this ), the width and height will be changed together preserving the original image aspect ratio. To restore the default size of the added image, click the Default Size button.

The Rotation tab contains the following parameters:

- Angle - use this option to rotate the image by an exactly specified angle. Enter the necessary value measured in degrees into the field or adjust it using the arrows on the right.
- Flipped - check the Horizontally box to flip the image horizontally (left to right) or check the Vertically box to flip the image vertically (upside down).

The Text Wrapping tab contains the following parameters:

- Wrapping Style - use this option to change the way the image is positioned relative to the text: it will either be a part of the text (in case you select the inline style) or bypassed by it from all sides (if you select one of the other styles).

  - Inline - the image is considered to be a part of the text, like a character, so when the text moves, the image moves as well. In this case the positioning options are inaccessible.

    If one of the following styles is selected, the image can be moved independently of the text and positioned on the page exactly:

  - Square - the text wraps the rectangular box that bounds the image.

  - Tight - the text wraps the actual image edges.

  - Through - the text wraps around the image edges and fills in the open white space within the image. So that the effect can appear, use the Edit Wrap Boundary option from the right-click menu.

  - Top and bottom - the text is only above and below the image.

  - In front - the image overlaps the text.

  - Behind - the text overlaps the image.

If you select the square, tight, through, or top and bottom style, you will be able to set up some additional parameters - distance from text at all sides (top, bottom, left, right).

The Position tab is available only if you select a wrapping style other than inline. This tab contains the following parameters that vary depending on the selected wrapping style:

- The Horizontal section allows you to select one of the following three image positioning types:
  - Alignment (left, center, right) relative to character, column, left margin, margin, page or right margin,
  - Absolute Position measured in absolute units i.e. Centimeters/Points/Inches (depending on the option specified at the File -> Advanced Settings... tab) to the right of character, column, left margin, margin, page or right margin,
  - Relative position measured in percent relative to the left margin, margin, page or right margin.
- The Vertical section allows you to select one of the following three image positioning types:
  - Alignment (top, center, bottom) relative to line, margin, bottom margin, paragraph, page or top margin,
  - Absolute Position measured in absolute units i.e. Centimeters/Points/Inches (depending on the option specified at the File -> Advanced Settings... tab) below line, margin, bottom margin, paragraph, page or top margin,
  - Relative position measured in percent relative to the margin, bottom margin, page or top margin.
- Move object with text controls whether the image moves as the text to which it is anchored moves.
- Allow overlap controls whether two images overlap or not if you drag them near each other on the page.

The Alternative Text tab allows to specify a Title and Description which will be read to the people with vision or cognitive impairments to help them better understand what information there is in the image.