Skip to main content Skip to footer


Learning Centre

Gallery

The Gallery component in Govstack allows you to add images and videos to your web page and get creative with how you display them. With this component, you can:

  • Add, format and style images on a page with more flexibility and layout options compared to just adding an image into a text component
  • Embed internal video files or external video links directly on a page
  • Create a gallery containing images, videos or a combination of both
  • Add a media folder to a page that will display all the images within that folder

Learn how to add and format images and videos using the Gallery component and explore the various settings you can use to change the look and feel of your gallery.

Upload an image or video

Before you can add an image to a Gallery component, you need to upload the image to the 'Media' tab in the Govstack back office. If you're planning to add an MP4 video to your gallery (versus a YouTube or Vimeo video), you need to upload the video to the 'Media' tab in advance as well.

Add a gallery to a page

To insert a Gallery component on a content page, you need to:

  1. Navigate to the page you'd like to add the gallery component to
  2. Select the 'Add content' button under the 'Main content' area of the page's 'Content' tab
  3. This will open the 'Add content' slide-out panel
  4. From here, select the "Gallery" component

This will open the 'Gallery' slide-out panel where you can add content and adjust the settings for the Gallery component.

Add content to a gallery

Using the 'Gallery' component, you can choose to add one of the following content options.

To add a single image to the page, follow these steps:

  1. Select the 'Add content' button from the 'Image/Video' field in the 'Gallery' slide-out panel
  2. Choose the 'Single Image' icon from the 'Add content' slide-out panel
  3. This will open the 'Single Image' slide-out panel
  4. From here, select the '+' icon to add an image
  5. This will open the 'Media' area in Govstack
  6. Select the folder that contains the image you'd like to add (to open the folder, you need to select the name of the folder, not the folder icon)
  7. Choose the image you'd like to add
  8.  Click the 'Select' button

Repeat these steps to add multiple images to the gallery. Alternatively, if you don't plan on adding captions or light window titles and footers to your images, you can add multiple images at once using the 'Multiple images' option.

Captions

With single images, you have the option to add a caption and light window captions.

Image captions

An 'Image caption' will appear overlaid on the image on the web page. If you'd like to add an overlaid image caption, add it in the 'Image caption' field.

Light window captions

A 'Light window title' will appear above the image when a user opens it. If you'd like to give your image a title that users can only view when they open the image, add it in the 'Light window title' field.

A 'Light window footer' will appear below the image when a user opens it. If you'd like to provide information or context for an image that users will have to open the image to view, add it in the 'Light window footer' field.

Disable the light window

The light window allows users to click on an image on a web page and open it to view it in a larger format. If you would like to disable the light window for an image, turn on the 'Disable light window' toggle.

You can add multiple images at once to a page. When you select this option, however, you are not able to add image captions or light window titles and footers. If you would like to have these on your images, you will need to add them individually with the 'Single image' option.

To add multiple images at once to a page, follow these steps:

  1. Select the 'Add content' button from the 'Image/Video' field in the 'Gallery' slide-out panel
  2. Choose the 'Multiple Images' icon from the 'Add content' slide-out panel
  3. This will open the 'Single Image' slide-out panel
  4. From here, select the '+' icon to add the images
  5. This will open the 'Media' area in Govstack
  6. Select the folder that contains the images you'd like to add (to open the folder, you need to select the name of the folder, not the folder icon)
  7. Choose the images you'd like to add
  8.  Click the 'Select' button

Disable the light window

The light window allows users to click on an image on a web page and open it to view it in a larger format. If you would like to disable the light window for your set of images, turn on the 'Disable light window' toggle.

To add a single video to the page, follow these steps:

  1. Select the 'Add content' button from the 'Image/Video' field in the 'Gallery' slide-out panel
  2. Choose the 'Single Video' icon from the 'Add content' slide-out panel
  3. This will open the 'Single Video' slide-out panel
  4. Select the source for the video you want to add to the gallery
  5. If you are using a video from YouTube or Vimeo, copy and paste the URL website address to the video in the 'Video' field
  6. You can also upload your own MP4 video file from your Media library by selecting the '+' icon next to the 'Video' field. From here, choose the folder that contains the video you'd like to add and select the video
  7. In the 'Image' section, upload an image from your Media library to use as a thumbnail for the video window. Do this by selecting the '+' icon next to the 'Image' field. From here, choose the folder that contains the image you'd like to add and select the image

Captions

With videos, you have the option to add a caption or light window captions.

Video captions

A 'Video caption' will appear overlaid on the video thumbnail on the web page. If you'd like to add an overlaid thumbnail caption, add it in the 'Video caption' field.

Light window captions

A 'Light window title' will appear above the video when a user views it. If you'd like to give your video a title that users can only view when they open and play the video, add it in the 'Light window title' field.

A 'Light window footer' will appear below the video when a user plays it. If you'd like to provide information or context for the video that users will have to open and play the video to view, add it in the 'Light window footer' field.

Disable the light window

The light window allows users to click on the video to open a larger window to view it on the web page. If you would like to disable the light window for your video, turn on the 'Disable light window' toggle. When the light window is disabled, users can only view the video directly on the web page as it appears.

You can add a media folder to your gallery which will automatically upload all the images and/or videos in that folder.

When you select this option, however, you are not able to add image or video captions or light window titles and footers. If you would like to have these on your images and videos, you will need to add them individually with the 'Single Image' or 'Single Video' options.

To add a media folder to a page, follow these steps:

  1. Select the 'Add content' button from the 'Image/Video' field in the 'Gallery' slide-out panel
  2. Choose the 'Media Folder' icon from the 'Add content' slide-out panel
  3. This will open the 'Media Folder' slide-out panel
  4. From here, select the '+' icon to add a media folder
  5. This will open the 'Media' area in Govstack
  6. Select the folder that you'd like to add
  7.  Click the 'Select' button

Include or exclude child folders

You can select whether or not to include child folders in the folder you uploaded. Child folders are folders that are housed within another, higher-level folder. If you include child folders, then any image or video files in that child folders will be added to your gallery as well.

To include child folder files in your gallery, select the 'Settings' tab in the 'Media Folder' slide-out panel. Next, turn on the 'Include child folders' toggle and press 'Submit'.

Disable the light window

The light window allows users to click on files in the folder you added to open a larger window to view it on the web page. If you would like to disable the light window for your uploaded files, turn on the 'Disable light window' toggle. When the light window is disabled, users can only view the image and/or video files directly on the web page as they appear there.

Gallery settings

Explore the different gallery settings to adjust the layout and function of your gallery. To access your gallery settings, select the 'Settings' tab in the 'Gallery' slide-out panel.

Design and layout

The 'Items per row' setting lets you choose how the images and/or videos in your gallery with be presented on the page. You can choose between one and eight items per row. Keep in mind that the shape you choose for your images and video thumbnails in the 'Image style' setting will affect what your gallery rows look like.

Turn on the 'Remove item spacing' toggle to remove the space between images and/or video thumbnails in your gallery.

In the 'Image style' setting, you can choose the shape of the images in your gallery.

If you select 'Original', then your images will appear with their original ratios on the page. Keep in mind that different images may have different ratios, so your gallery may display images of different shapes if you select this option.

If you select one of the ratio options, then all the images in the gallery will display in that ratio. The first number in each ratio represents the width while the second number represents the height. For example, a 2:1 image would be twice as wide as it is high.

If your image is cropped oddly or doesn't look the way you want it to after adjusting the image style, you may need to change its focal point so that it crops properly when changing the image ratio. Learn how to change the focal point of an image in your gallery in the 'Media' tab in the Govstack main menu.

After you select an image style in the 'Image style' settings, your gallery images will automatically be cropped to match your selection. However, you may prefer to have your images retain their original ratios while still having a consistent ratio display. To do this, turn on the 'Box pad' toggle to add padding around images to match the image style you have selected.

Turn on the 'Enable random order' toggle if you want the order of your gallery images and videos to be randomized every time a user visits the page.

You can set up your gallery to display in carousel mode where it displays images in a single row and cycles through them at regular defined intervals. To have your gallery display in a carousel, turn on the 'Enable carousel' toggle.

Allow users to scroll through a carousel gallery

If you want users to be able to scroll through a carousel gallery themselves, rather than waiting for it to auto-scroll, you can either:

  • Add left and right arrow buttons that users can select to move through the carousel. To do this, turn on the 'Show arrows' toggle
  • Add clickable dots below the carousel gallery that users can select to view any image in the gallery. To do this, turn on the 'Show dots' toggle

Set the carousel rotation speed

Next to 'Auto rotate speed', use the slider to choose how often the carousel will automatically rotate images. You can choose anywhere between one and 10 seconds.

These settings will be available only if the component is contained within a split component.

Using the 'Column Width' sliders you can set the width of the component in split components. The slider allows for column widths from 1 to 12. A minimum width of 2 is recommended.

The total width settings for 'Split Section 1' and 'Split Section 2' should equal 12. If the sum of 'Split Section 1' and 'Split Section 2' is greater than 12, your split content will appear on two rows.

Separate options are available for desktop and tablet size screens. On mobile screens split components switch to a single column.

Component

You can customize the content colours of the component using the colours that are part of your website design. Depending on your website design, you can add a coloured background behind the component to create a hot spot on the page. 

Colour options

The colour options are based on the design of your website. You may be able to change the design colours depending on your Govstack plan. To get access to the website design features, speak with your GHD Digital Account Executive.

If you'd like, you can add an image to the background of your component. To do this, you need to:

  1. Select the "+" icon next to the "Background image" field
  2. This will open the 'Media' folder
  3. From here, choose the folder that contains the image you'd like to add
  4. Select the image you'd like to insert
  5. Press the "Select" button 

Please note

Background images ignore the focal point and cropping information added to your image in the media tab. Instead they use the settings provided under "Background image options".

Adding an image behind text can cause colour contrast issues for users with low vision or colour blindness. You should only add an image behind text if it meets the colour contrast ratio requirements associated with accessibility legislation in your region.

Background images do not use alternative text and are not called out for those using screen readers. Make sure that background images do not contain information critical to understanding the meaning or context of your content.

You can also set a few options for a background image, including the placement of the image, size of the image and whether or not the image repeats. 

Image Size

These settings replace the cropping and sizing settings added in the media section image editor.

Cover - The image will stretch to fill the available space. This is the most popular option for a single image background.

Full-Width - The image stretches to fill the full width of the available space. Depending on the characteristics of the image this may result in gaps at the top and bottom of the component.

Auto - The image displays at it's actual size. This may leave gaps around the edges of your component.

Repeat - The background image with tile vertically and horizontally. Use a smaller image or a tiling image for best results.

Repeat Horizontal - As repeat but the background image tiles in a single row.

Repeat Vertical - As repeat but the background image tiles in a single column.

Image Placement

This setting replaces the focal point setting added in the media section image editor.

Select the origin point of your background image. The image will fill the space behind your component starting from the selected point. You may need to experiment to find the best contrast and focal point position for each image.

This setting only applies if you are using a page with a 'Full' page layout. Typically, full page layouts are reserved for the home page of your website or any landing pages you've created.

Animation

You can add animation to the component by selecting the 'Animate' toggle. Once the 'Animate' toggle is selected, you'll have the option to customize the:

  • Animation style
  • Animation delay (seconds)
  • Animation duration (seconds)

From the 'Animation style' dropdown menu, select the type of animation you'd like to add to the accordion. There are a variety of different animation options in the following categories:

  • Attention Seekers
  • Bouncing Entrances
  • Fading Entrances
  • Flippers
  • Light Speed
  • Rotating Entrances
  • Sliding Entrances
  • Zoom Entrances
  • Specials

We recommend testing out a variety of animation styles to select the one you like the most. 

Please note

Animation styles can cause accessibility issues for some users visiting your website. For example, some users may experience motion sickness when viewing animated elements on your website.

Using the 'Animation delay' slider select the time in seconds that you'd like to delay the animation. 

Please note

Animation delay can cause accessibility issues for some users visiting your website. Certain animation styles and delays can combine to make your animated component invisible to screen readers. Please test your animations to make sure they are accessible.

You can select how long you'd like the animation to last on the component by using the 'Animation duration' slider. Select the number of seconds you'd like the animation to continue on the public website. 

Advanced

In the 'Name' field you can give a unique name to the component. This will make it easier to differentiate between components, both on your page as well as in your clipboard.

You can create an anchor link that will link a user directly to the top of this component. 

When linking to this page add the anchor to the "Anchor / querystring" field in the "Select link" dialogue box. The link will then jump to the top of the target component rather than to the top of the page.

Note that anchor names are case sensitive. For best results use lowercase characters, numbers, and dashes only. Avoid spaces and special characters.

In the 'Custom classes' field, you can add any custom CSS classes you may have. Custom CSS classes can be found in the Design node under the 'CSS' tab in the backend of Govstack. 

If you'd like to add more than one custom class, you'll need to leave a space between each class. 

Please note

Depending on your Govstack plan, you may not be able to access the Design node in the backend. If you'd like to be able to add custom CSS and get access to the website design, contact your GHD Digital Account Executive.

We cannot guarantee that future updates to Govstack will not break or negatively impact custom CSS.

You can select additional styles to the component, including:

  • Spacing
  • Visibility
  • Design

Spacing

You can remove the spacing around the component by selecting one of the following options:

  • Remove spacing
  • Remove spacing top only
  • Remove spacing bottom only

Visibility

You can customize the visibility of the component. Select one of the following options:

  • Hide on all screens
  • Hide on extra small screens
  • Hide on small screens
  • Hide on medium screens
  • Hide on large screens
  • Hide on extra large screens

Design

Select one of the following options if you'd like to customize the design of the component:

  • Show shadows - this will add a shadow effect to the component. Note that by default most Govstack websites do not have shadows. You can add these in the Design node
  • Sticky - the component will stay on the screen even as users scroll down the page

Turn on the 'Hide from website' toggle if you'd like to hide this component from the web page.

Preview and publish changes

Once you've added a gallery to your page, make sure to preview and publish the page to complete the process.