You are here: Home Plone Book Kupu Insert Image

Kupu Insert Image Properties

by Olha Pelishok last modified 2010-05-18

This article applies to Kupu 1.4 and Plone 3.0, Plone 2.5, Plone 2.1

We recommend you to watch Insert image with Kupu screencast.

Kupu editor allows you to insert image files stored in Plone into your document, using the image button on the Kupu toolbar: 



Clicking this button launches the Insert Image dialog:



The three columns of the dialog display:

  • In the first column - a folder navigation list.
  • In the second column - an object navigation list, from which you can select your image file.
  • In the third column - image preview, and options for alignment, size and captions.

In the example above, an image of a rose was selected - rose.png (rather large one, at its original size of 600*450 pixels).


According to the "Image alignment

" option you choose, the image will be placed in your page (and the following HTML code will be generated):

  • lefthand (<img class="image-left captioned" src="rose.png" alt="rose" />);
  • righthand (<img class="image-right captioned" src="rose.png" alt="rose" />);
  • inline (<img class="image-inline captioned" src="rose.png" alt="rose" />).


You may also choose the size of the image you need. This is especially convenient when you deal with large images, as there is no need to use Photoshop or other external image editing application to crop or change the size of an image. The "Image size" dropdown list provides a choice between many sizes and formats:



  • Large (<img src="rose.png/image_large" alt="rose" />);
  • Preview (<img src="rose.png/image_preview" alt="rose" />) - an image is inserted in its original size;
  • Mini (<img src="rose.png/image_mini" alt="rose" />) - the minimum-size image is formed;
  • Thumb (<img src="rose.png/image_thumb" alt="rose" />) - a thumb(inch)-size icon is made out of your image (little bigger than 2,5cm);
  • Tile (<img src="rose.png/image_tile" alt="rose" />) - a tile is made out of your image;
  • Icon (<img src="rose.png/image_icon" alt="rose" />) - an icon is made out of your image;
  • Listing (<img src="rose.png/image_listing" alt="rose" />) - a listing icon is made out of your image;



The following pictures display all the formats and sizes that can be inserted using a single image file in Kupu. Note that this image is 600*450 pixels, so the largest version (original) can not be larger than this aspect ratio:

rose listing (16,16) rose

icon (32, 32) rose


tile (64,64)




thumb (128, 128)








mini (200, 200)











preview (400, 400)



































original (600, 450)




Image Captioning

It is possible to put image caption under the image in Kupu 1.4 version. Caption is taken from image description. Alt text is taken from image title.

Alt text and caption update if image is updated.

To enable image captioning go to Site Setup -> Visual Editor. Make sure that you have Link using UIDs and Allow captioned images selected in Kupu Configuration.





When you add image to the site, you can put some text into its description that will be displayed as an image caption.




Now when we create a page, and insert image into it, check the box Caption:



Save this page, and you will see the image followed by its description as the caption all inserted into a frame:




Document Actions
Powered by Plone