On This Page


The Image User Item adds an image to a page.

An Image User Item is a Content Item and does not create a page of its own. You must add it to a Page User Item or you will not see its content.

The Image User Item is for images that are not image exhibits. Image exhibits are images that are attached to records in your genealogy program. You manage image exhibits via properties in the Data > Exhibits section.

Image Section Properties


The Title property identifies the User Item in the User Items list. The Title has no other purpose for Image User Items.


See Enabled in the Common Properties section of the User Items help page.


Click the Image button to select the image file you want to add to the page. GedSite will open a standard Windows "open file" dialog window. Use the navigation controls in that dialog window to move to the folder that contains the image you want to use. Select the image file, then click the [Open] button. GedSite will load the image file and display the image.

The image file is copied to the ui (user images) subfolder of the Input (-i) folder when you select the image file. If you subsequently change the original image file, the change will not be reflected in the site contents. You must edit the Image User Item and re-select the original file to update the copy used by the site. Optionally, you may manually update the copy of the file that is stored under the ui subfolder of the Input (-i) folder.

Use Embedded Caption

When the Use Embedded Caption property is checked, GedSite will attempt to read a caption from the metadata stored with the image in the image file.

When the Use Embedded Caption property is unchecked, GedSite will ignore the caption (if any) stored in the image file and use the Caption property text instead.


The Caption property is enabled when Use Embedded Caption is unchecked. When the Caption property is enabled, GedSite will use the contents of the Caption textbox as the caption for the image.


See Clear in the Common Properties section of the User Items help page.


The Class textbox allows you to specify the name of a CSS class that will be added to the image's container. You may use the class in the selector of a User Style to customize the appearance of any Image User Items with the specified class name.

Page Section

See Page Section in the Common Properties section of the User Items help page.


The Alignment pull-down menu controls whether the image appears inline, floats left, is centered, or floats right. When floated left or right, any subsequent content will flow around the picture on the opposite side.

Show Lightbox

When Show Lightbox is checked, which is the default, the image will include the Lightbox buttons.

Thumbnail Section Properties


If the Option property is set to "Thumbnail", GedSite will make a reduced-size version of the image and insert the reduced size image on the page. The Width and Height properties determine the maximum dimensions of the reduced-size image. If the Width and Height properties are larger than the Width and Height of the image, the image will not be enlarged.

When GedSite creates a thumbnail image, the thumbnail will have the same aspect ratio as the original image.


The Width property determines the maximum width of the reduced-size version of the image.


The Height property determines the maximum height of the reduced-size version of the image.

The Type property may be set to "No Link", "Link to person", or "Link to URL". When Type is set to "No Link", the image is not a link. This is the default.


When Type is set to "Link to URL", the URL textbox is enabled. Enter the URL of a page. The image will become a link to the designated URL.


When Type is set to "Link to person", the ID textbox is enabled and you may set it by keying the ID number of a person or choosing a person via the Picklist... button. The image will become a link to the designated person.

Add Reference

When Type is set to "Link to person", the Add Reference checkbox is enabled. If Add Reference is checked, GedSite will add a link-type reference to the linked person. The reference will will create a link to the page where this image appears.