Insert a new image

You can import a new image into the Content Store and insert it at the cursor position in your topic.

1. Lock your topic and place your cursor in the location where you want to insert the image.
2. Do one of the following:
   • Press CTRL+ALT+I.
   • On the Document Creation toolbar, click the Create Image button ().
   • From the menu bar, select DITA CMS > Create Image.
   The Show/Edit Image dialog appears.
3. In the Title box, type a title for the image object.
   Titles do not need to be unique.
4. In the Description box, type a description of the object which can be useful to identify the image in a search.
   This information becomes part of the file metadata. Enter all the keywords that you think may be useful when you want to search for the file.
5. In the Image Type list, select the type of image being imported. The types displayed depend on what is configured in your deployment.
6. If the image contains text that requires localization, select Needs Translation.
   Note: If Needs Translation is not selected, then when the map is put into the Localization cycle, the image will automatically be given the status of Localization:review (or its equivalent in your workflow).
7. In the Language list, click the language used in the image.
8. In the Images area, select a Format name.

   Format names represent the different graphic formats or resolutions that your system uses with different types of output. The format names displayed vary according to how your system is configured.

   Note: A line with no image details (no Mime Type, Width, Height) means that there is no image in the repository for that format.

   
9. Click Import.
   The Open dialog appears.
10. Navigate to the required image, select it, and click Open.
    Tip: You can configure a default import directory where the Open dialog will go automatically by configuring the Import Export options in Preferences.
    The Show/Edit Image dialog reappears. The Images area displays the new image's Mime type, Width, and Height, and the image itself is previewed at the side.
11. Repeat the import process for the different formats you need for that image.
    Once an image has been imported into the repository for a specific format name, that line displays in green to indicate that this is a new image. The default image is displayed in bold.

    

12. Select the image format that you want to use as the default and click Set as Default.
    This is the image that will appear in the Preview view. It is also the image that will be substituted if the Output Generator cannot find the format specified by a transformation template.
13. In the Labels pane, click Select to add labels.
    The labels that you select are listed in the Labels pane.
14. If you want to insert the image into the topic currently open in the XML editor, select the Insert image at the cursor position checkbox.

    The checkbox is available and selected by default when a topic is open and locked in the XML editor. If the Insert image at the cursor position checkbox is not selected, the image object will be created in the Content Store, but not inserted into a topic.

    Note: This feature is not supported in XMetaL XML EditorXMetaL XML Editor.
15. Optional: To save the settings you have selected for Language and Image Type, click Save Settings.
    Your selections are saved and used as the default values in the Show/Edit Image dialog.
16. The following steps depends on whether the Dynamic Release Management module is enabled in your deployment. Do one of the following:
    • If you see the Next button at the bottom of the Show/Edit Image dialog, this module is enabled in your deployment. Click Next to specify the release management details.
    • Otherwise, this module is not enabled. Click OK to create the image. You have completed this procedure.
17. If the Insert image at the cursor position checkbox is not selected, you must choose into which product or library the image is added. When the checkbox is selected, the image is added to the same product or library as the topic so you can skip this step. To choose the product or library:
    1. In the Add Object To pane, select Products or Libraries.
    2. In the All Products or All Libraries pane, select the product or library for which you would like to display the releases and versions.
       Use the filter at the bottom of the pane to filter the objects in the list by name.
       The releases and versions for the product or library selected are displayed in the Selected Products/Libraries, Releases, and Versions pane.
    3. To exclude products/libraries, releases, and versions according to the exclusion filters, click Apply global exclusion filter settings.
18. In the Selected Products/Libraries, Releases, and Versions pane, select the versions in which the object can be used.
    Use the filter at the bottom of the pane to filter the objects by release name.
    The Primary Version drop-down list is populated with the list of selected versions.
19. In the Primary Version list, select the primary version for the object.

    The primary version is the version for which the object was initially created.

20. Optional: To save the settings you have selected in this dialog, click Save Settings.
    Your selections are saved and used as the default values in the Select Versions dialog.
21. When you are finished, click Create.