Setting Up a Gallery

Gallery is an app that enables you to create beautiful social media galleries for your business, event or client without any IT or developer involvement.

Galleries can be independent or linked to a Competition or Reward.

Gallery Overview

Every business can benefit from displaying media in some form or another, whether it's customer testimonials, curation of a specific #hashtag that's linked to a promotional campaign or images of customers using a specific product

Many businesses don't realise the potential that lies in displaying media from customers, clients and themselves in a way that drives a meaningful connection with customers.

That's where Gallery comes in. We make it incredibly easy to build a beautiful, responsive (and embeddable) Gallery that you can install wherever you want. What's more, Gallery pulls in data from a huge variety of sources including Instagram, Facebook and even Competitions or Rewards.

Creating A Gallery

To create a Gallery just head to the Gallery tab in the left menu, then click the New Gallery button at the top right.

Gallery offers a live preview as you setup each element, which means that you just need to build something that suits your brand or style.

Gallery Setup

The first tab allows you to setup much of the basic functionality of your Gallery including the:

  • Type
  • Name
  • Language
  • Sharing
  • Voting
  • Moderation

Gallery Type

The type of Gallery that you're able to build will depend on your plan (Competitions & Rewards have access to the Basic Gallery).

This guide assumes that you have a Gallery plan and will be using the Gallery App.


The Name for your Gallery is an internal name that's shown on your Dashboard or when viewing your reporting.

This name doesn't show in the URL for the Gallery:

Import Start Date

By default the Gallery will attempt to pull in as many items as it can until it hits your Historical Import limit.

You can set a specific start date for the import during setup, the Historical Import will then import either up until your limit or until the start date is reached (i.e. it won't import anything from before your start date).


You can select from any of our 25+ supported languages for your Gallery. This will translate any of the fixed text in the Gallery.

You will still need to translate any of your own dynamic text for elements like the Header & Description

Gallery Text Overrides

You are able to change any text within our Gallery. To change the text, simply add the key for the text and a value in quotes (it uses YAML layout). You only need to add overrides - don't paste the whole file in.

In the reference bundle, you see this:

gallery_no_entries: "Nothing to show yet"
gallery_most_recent: "Most Recent"
gallery_most_popular: "Most Popular"
gallery_load_more: "Load More"
gallery_link_copied: "Link copied!"

To change them, add this to the Widget Text Overrides:

gallery_no_entries: "No Uploads Just Yet"
gallery_most_recent: "Latest"
gallery_most_popular: "Most Voted"
gallery_load_more: "View More Photos"
gallery_link_copied: "Copied!"

And here's what it looks like in the Gleam UI:

The full list of text that you can override is in this downloadable file:

View Gallery Overrides List

Enable Sharing

Enabling this option allows users to share individual Gallery items from the modal.

Users can share via:

  • Email
  • Facebook
  • Twitter
  • Pinterest
  • Tumblr

Or copy the unique share URL to their clipboard (and share elsewhere).

When a user shares a specific link it will link any users back to the same image that was shared, this will work on the Gleam Hosted Gallery or if you have it embedded on your own landing page.

Enable Voting

If you enable voting then users will be able to vote on their favourite images (which you can then see in the backend leaderboard).

You have two options when enabling voting:

  • Allow Anonymous Votes: This allows users to vote without having to login to the Gallery and is based on IP/Session
  • Require Social Login: This forces users to login with Facebook in order to vote, this option is recommended

Enabling voting will also add a filter to the Gallery which allows users to see the most recent or most popular images.

Enable Moderation

By default the Gallery will display all imported items. This option turns on a moderation queue, which allows you to approve photos via the Pending tab before they become available to the public.

Even with this option turned off it is possible to reject photos, so you can decide if you'd prefer to let everything through and reject or turn on moderation and approve everything.

Gallery Import

Adding Import sources to your Gallery is how you populate it with media and other items that the Gallery displays. There are two main ways to import items into your Gallery:

Campaign Import

Gallery can be used alongside both Competitions and Rewards to display media collected from those campaigns.

Multi-Campaign Import

On some Premium plans you can import from multiple campaigns at once, this is useful if you're running multiple campaigns and you need them to feed into the one Gallery.

Linking a campaign enables the Campaign Button option in the Header tab which allows users to enter the campaign from within the Gallery.

Import Sources

Gallery offers a wide range of sources for you to import media from, for more details on each individual source click below to view those specific docs.

  • Facebook > Posts to Page
  • Facebook > Post / Photo Comments
  • Facebook > Page
  • Instagram > #hashtag
  • Instagram > Profile
  • Instagram > Instagram Location
  • Twitter > #hashtag
  • Twitter > Profile
  • Pinterest > Board
  • Soundcloud > Profile
  • Tumblr > Blog
  • Tumblr > #hashtag
  • YouTube > #hashtag
  • YouTube > Channel

Look & Feel

Making sure your Gallery looks the way you want it to is a huge part of the setup process. We offer a huge range of customisation inside the Gallery to help you engage your customers.


The Header tab allows you to control the area above where the Gallery items are displayed. This section is off by default.


The Cover section sits above the logo, you can use a solid colour, gradient or upload an image which will stretch to fit. Once you've done that you can set the height of this section.

The Cover can be used by itself if you wanted a larger image with text or to have a completely branded header.


You can upload your logo to sit between the Cover & Text sections of the Gallery. We allow you to wrap the logo in a circle or have it sit raw on the Gallery (useful for wider logos).


The Text area allows you to personalise the header with a Title and also a description. Useful for letting users know what the Gallery is about or asking them to do something (use this #hashtag etc).


In the links tab you can see various links to social media accounts or even a CTA to visit your store or product.

The colour of each link matches the respective social network, but you can override this to match your branding.


The content tab allows you to control the appearance and behaviour of all the content inside your Gallery.


Before a user interacts with any of the items in your Gallery they sit naturally in a preview state on the page.

This section allows you to configure how the Gallery items look:

  • Spacing: Set the px value of spacing between the Gallery previews
  • Body Margin: The Gallery has a natural 15px margin around the edges, easilty configure this or remove it completely
  • Border Radius: Give the previews a border radius or make them square
  • Width: Choose from Small, Medium or Large preview widths
  • Square Media: This option allows you to make all the items in your Gallery square for consistency
  • Normalize Media Height: Allows you to force all items in your Gallery to have a consistent height
  • Show User Info: Allows you to show the profile photo and name of the uploader
  • Show Description on Hover: Show the description or caption of the Gallery item on hover
  • Show Source Icon on Hover: Show the source of the Gallery item (i.e. Instagram or Twitter)


Highlighting allows you to feature one of the items in your Gallery at regular intervals. This feature can really help give you Gallery more vibrance.

Using highlighting will automatically enable the Normalize Media Height option so that the media looks consistent.

Custom Columns

Custo Columns is a premium feature that allows you to fully customise how many columns show at very specific screen sizes. This can be useful if you want to show 4 columns on a TV, but only show 1 column if a customer views the Gallery on a mobile device.

Supported resolution ranges:

  • iPhone
  • iPad
  • iPad Pro
  • Laptop
  • Desktop / TV
  • 2K Display


Set a custom background colour for the entire Gallery or even upload a background image using this section.

The background image will automatically scale to fit the width of the users device or embedded page.


The popout section allows you to configure how your Gallery item looks once it's clicked by the user to view.

It features a number of options:

  • Border Radius: Give your popout rounded borders
  • Enable Sharing: Enable the ability for users to share Gallery items
  • Show User Info: Show or hide the profile photo and name of the uploader
  • Show Source Icon: Show or hide the source of the Gallery item
  • Show Description: Show or hide the description of the Gallery item
  • Enable Voting: Enable the ability for users to vote on Gallery items

Vertical Layout

We also offer a narrower vertical layout which can be forced by enabling the Vertical Layout option.

Popout Background

This option allows you to give the popout a specific background colour when in an opened state. You can also set opacity and change the colours depending on mobile or desktop.

Load More Button

When the Gallery is embedded in a page it'll show a certain number of Gallery items before displaying a Load More button. This is to prevent the Gallery completely taking over the page and showing everything at once.

You can configure text, colour and also apperance of the Load More button in this section.

The Advanced tab allows you to control how many items show before the Load More button shows, or if it even shows at all.


The advanced tab contains a number of additional features for users on some of our higher plans.

Installing Your Gallery

There's quite a few flexible options to install your Gallery once you've built it.

Hosted Gallery Page

The default option is our hosted landing page. This is a page that sits on the domain and will show the Gallery at all times. We also use this landing page with Share links so we can show the user their Share to vote on.

Embed On Your Site

When choosing to embed on your site, you can set a few options first. For example you can choose to completely remove the header and just embed the images if you wish.

Once you've selected your options you'll see two piece of code to embed. The first piece of code should code in your header or template.

The second piece of code embeds the Gallery on your page. So just put that where you'd like the Gallery to show. Our Gallery is responsive, so it'll scale to fit within the size of the holding page.

Install To Facebook

The final option allows you to embed your Gallery inside a Facebook tab. Again just choose your configuration, then click the Facebook install link.