Images

When you open a topic or snippet, you can insert an image into it.

Permission Required?

Editing content and project files is an activity available to users with the Author status. By default, users with Author status have the following permissions set:

  • If this is deselected, then viewing files in a read-only mode is allowed. On the left side of the page, the Files vertical three-dot menu is not available.

  • If this is deselected, the XHTML in the Code view is read-only.

    Editing code is regarded as a capability for an advanced user. If not done properly, the code can become malformed quickly. Administrators can prevent users from editing the code by deselecting the Edit Code permission.

For more information about permissions, see Setting User Permissions or Setting Team Permissions.

How to Insert Images

  1. Open a project, and select the Files tab at the top.

  2. On the left, navigate to a topic or snippet file. The file contents display on the right.

  3. In the upper-right of the Content Editor, click Edit.

  4. From the Content Editor's local toolbar, click Button for inserting a project image using the Content Editor in Central..

  5. In the Insert Image dialog, select whether you want to insert a new image from the Project (i.e., a file you have already added to your project), Web (e.g., an image link), or Data URI (e.g., a base64 encoded string).

  6. If you selected Project, click in the File field, then navigate to and choose the file from your project. If you selected Web, enter or paste the link path.

    If you selected Web, click in the Web field, and enter or paste the link path. Be advised that the link only points to the Web and the image will not be copied to the project.

    If you selected Data URI, click in the Data URI field, enter or paste a data URI (Uniform Resource Identifier) string. Instead of linking to an image file, the data URI scheme lets you embed the image directly into the document (e.g., HTML). Data URIs allow for fast and reliable image loading, and are supported by most Web browsers.

  7. (Optional) You can add alternate text (i.e., alt text) to the image. Alternate text is used to display when the image is not available, such as when a disabled individual is using a screen reader. Click the Alternate Text field and enter a description.

  8. (Optional) You can change the size of the image. Select to make selections in a popup. The Height or Width field at the top of the popup lets you select a variety of settings. See Height and Width Settings. The Unit field at the bottom of the popup lets you select a variety of absolute and relative units of measurement. See Units of Measurement.

  9. Click Save the active file. to save your work. Image files display within the <img> tag in the code.

How to Edit Image Properties

  1. Open a project, and select the Files tab at the top.

  2. On the left, navigate to a topic or snippet file. The file contents display on the right.

  3. In the upper-right of the Content Editor, click Edit.

  4. Select an image that you want to edit.

  5. From the Content Editor's local toolbar, click Button for inserting a project image using the Content Editor in Central..

  6. In the dialog, select whether you want to insert a new image from the Project (i.e., a file you have already added to your project), Web (e.g., an image link), or Data URI (e.g., a base64 encoded string).

  7. If you selected Project, click in the File field, then navigate to and choose the file from your project.

    If you selected Web, click in the Web field, and enter or paste the link path. Be advised that the link only points to the Web and the image will not be copied to the project.

    If you selected Data URI, click in the Data URI field, enter or paste a data URI (Uniform Resource Identifier) string. Instead of linking to an image file, the data URI scheme lets you embed the image directly into the document (e.g., HTML). Data URIs allow for fast and reliable image loading, and are supported by most Web browsers.

  8. (Optional) You can add alternate text (i.e., alt text) to the image. Alternate text is used to display when the image is not available, such as when a disabled individual is using a screen reader. Click the Alternate Text field and enter a description.

  9. (Optional) You can change the size of the image. Select to make selections in a popup. The Height or Width field at the top of the popup lets you select a variety of settings (see Height and Width Settings). The Unit field at the bottom of the popup lets you select a variety of absolute and relative units of measurement (see Units of Measurement).

  10. Click Save the active file. to save your work. Image files display within the <img> tag in the code.

Note When resizing objects, you can ensure the aspect ratio is maintained. For example, if you want certain objects to be resized so that each is exactly 3 inches high, you can make sure the width of each object is adjusted accordingly to stay in proportion. To do this, first set the height at 3 inches. You would not set the width property at all. In the same way, if you were to specify an exact width, you could maintain the aspect ratio by not setting the height.

Note Please be aware that if you are using percentage for the size of an object, the percentage refers to the block containing that object, not to the object itself. For example, if you have an object in a topic and set the width to 60%, this does not mean that the object will be reduced to 60% of its size. Instead, it means that the object will be resized so that its width is 60% of the "container" where it is inserted.

Note By default, a new image does not contain an alternate text attribute, unless you specifically add alt text in the Insert Or Edit Image dialog. However, alt attributes on images are required for Section 508 compliance, even if the string is empty or null (alt=""). See www.section508.gov.

File Types Supported

  • PNG

  • GIF

  • JPG

  • BMP

  • SVG

  • TIFF

File Size Limit

15 MB

Dragging and Dropping Images

You can drag and drop images inside a topic or snippet in Central. When you click on an image and begin dragging, you'll notice a somewhat transparent version of the image following your mouse.

After releasing the mouse button, the image is settled into its new location.

Copying and Pasting Images

You can copy and paste images, but only when you are doing so within the same topic or snippet. It does not work from outside sources.