This feature available on All Plans (except where noted)
Contents
Widget Settings
Entry Source
Display Options
Filtering
Default Fields
Voting
Restrictions
Text
Sharing
Visibility
CSS Class
Overview
Use the Entry Display Widget to display entries that were submitted to your ShortStack lists via a Form Widget or via our Instagram/Twitter Feeds feature. You can also enable voting on those entries, for voting contests.
To add one of these widgets to your campaign, click the Entry Display Widget icon in the Add Widgets Panel, or click and drag the icon into your preview area.
Widget Settings
The widget settings popup is where you'll make any needed changes to your Entry Display Widget. To change the widget name, click on the pencil icon in the top-left (next to the name) then type your new name.
You will also see the CSS ID (starting with a #) of your new widget listed in the top-right corner of the popup.
You'll want to move through each item in the menu on the left side to make sure you've completely customized the Entry Display Widget (and what you're displaying) in the way you'd like. You can navigate through these sections using the Back and Next buttons at the bottom.
When you're finished making changes to your widget, click the blue Save and Exit button.
Entry Source
In the Entry Source section, select the list that has the entries that you're wishing to display. To select a list, click on the link after Connect to Existing Source.
Then, select your list from the popup.
To create a new list, click on Create New Entry Source.
In the popup, enter a name, the number of test entries to add to the new list, and any needed tags. Then click the Create and Continue to Form Designer button to continue creating your form, which will be what feeds entries to your new list.
More information on building forms is available in the Form Designer help doc.
Display Options
To arrange the order in which your entries are shown, use the settings in the Display Options section. To start, use the Sort entries from link to arrange your entries from newest to oldest, least to most votes, or most to least votes.
You can use the Entries per page field to set how many entries are shown before the widget starts adding additional pages. The maximum is 30 entries per page.
Note: If you need to display more than 30 entries per page, reach out to our support team for assistance.
By default; if someone clicks on a entry shared to social media, they will be taken to your campaign with the share appearing in a pop-up. To disable this, check the box in the Advanced Options section.
Filtering
You can choose Include or Do not include unapproved entries in the Filtering section. Not including unapproved entries allows you to curate entries before they're shown live on your campaign.
You can also choose if you want to filter your entries by the number of votes/points each entry has. The default is Do not filter.
Click to switch over to Filter and additional options will pop in. Use the field to change how many of the top entries you'd like to display, and use the dropdown to choose which voting round (if you have more than one).
Default Fields
The Default Fields section is where you can tweak different settings that affect how your entries are displayed in the widget.
The first things you'll notice are the checkboxes on the right. These are how you'll determine what shows in the tiles for each entry (in the campaign view) and what shows in the popup that appears when you click any given tile. Simply check the box if you want that item to appear, or uncheck it if you don't.
There are additional options available for the Entrant name/user name field - click on the down arrow to expand that section.
Click on the link after Show to select how you want the name to be displayed on the entries. Your options are First name & Last initial (the default option), First name & Last name, First name & Last initial, First initial & Last name, First name only, Last name only, or you can choose to Hide the name completely.
If you've chosen to include Facebook Login as part of your entries, you can select whether to Show or Hide the entrant's Facebook profile image in the entry here.
Media sorting options can be changed by clicking the down arrow next to Photo/Videos on the right.
You'll then see how to change what media shows by default in the entry's tile. Clicking the link, you'll see your options are first uploaded media, first video uploaded, or first photo uploaded.
Voting
If you're looking to let the public vote on your entries, you can set that up in the Voting section. Click the link after Voting is to set it to enabled or disabled.
Directly beneath that, you can set whether or not to show your votes. You can toggle the vote count link to Show or Hide.
For multi-round voting contests, you have the option here to switch between voting rounds.
Determine how many entries are shown in each round using the Filtering section.
You can schedule when you want voting to start and end using the Start/Stop voting on specific dates section. Simply use the fields to set a Start and End date, and here you also have quick access to alter the campaign's Time Zone. To alleviate any confusion, you'd generally want the time zone set to the geographical location of your entrants.
Restrictions
Note: This section will only be visible if voting is enabled.
ShortStack gives you a few different tools for enforcing voting rules in your campaign in the Restriction section. Use the Restrict votes by link to choose between our four different restriction methods:
- No Restrictions: Anyone can vote as many times and for as many entries as they would like.
- Anonymous Fingerprint: This option uses a combination of the voter's browser version and anonymized IP address. Before storing, we anonymize the information with a one-way cryptographic hash. This ensures that no part of this information can trace the vote back to a specific person or machine; this method is GDPR compliant.
- Anonymous IP: This option is a little bit stricter than Anonymous Fingerprint, as it uses only an anonymized version of the voter's IP address without the browser data. Voters in the same network (typically in an office environment) may run into issues with voting more than once.
- Email address: (Available on Agency Plan or higher) Selecting this allows you to restrict votes by having the voter submit an email address, which then has to be verified via an emailed code for the vote to count.
Below that, you can set the frequency at which people can vote for entries. Enter a value into the Participants may vote field.
Next, select whether the visitor can vote that many times per entry or per campaign.
Then choose only or every.
Selecting every will provide more timing options. Click the link to choose between days, hours, minutes, seconds, or calendar days, then enter the number of your selected unit in the field.
When you're done, your options should read as a clear statement saying how often visitors can vote:
If you'd like to change the message that displays when someone has already voted, you can do so using the Error message... field.
In the Additional Options section, you can enable a hidden Captcha for the Voting Widget that is completely transparent to the voters. It uses Google's reCaptcha behind the scenes to decide if the voter is a bot. If it thinks they are, it will reject the vote. With the slider bar, you may adjust the sensitivity - higher is more restrictive.
For information on how reCaptcha decides who is a bot and who isn't, you can check out this page.
Note: A voter accessing the campaign in their browser's Incognito Mode will likely trigger the bot detection.
Additional Email Address Restriction Settings
Selecting the Email address restriction will require a bit of additional configuration. For more information on that process, check out our Setting Up Email Login for Voting help doc.
Text
You can change any of the default Text that appears in the widget by making changes here. Find the text that you want to replace in the left column, then type your replacement text in the field immediately to the right.
Sharing
Fine-tuning how the entries can be shared is done in the Sharing section. To start: enable sharing by checking this box at the top.
When you enable sharing, more options will pop in allowing you to get more granular with your entry sharing.
You can choose between showing the title, description, and image as provided in the entry, or you can use custom settings for each. Just click entry or custom to toggle the settings back and forth.
Below, you'll see a listing of all available share methods; click and drag the 
icon to change the position in which that social media channel appears, and select which channels to use by checking/unchecking the box on the left of the name. The currently selected channel's name will be highlighted.
If you've selected custom for the title, description, or image; you'll be able to customize the settings for the selected social media channel on the right - the share is shown as a preview. Each channel will have slightly different settings (depending on how the site handles sharing), so make sure to click through all of the channels you're using to make sure each one is customized to your liking.
Visibility
If you'd like to limit visibility of the widget to a specific date and time, make the widget a popup, only show the widget in your Builder, or limit in which country/countries the widget can be seen; you'd do so here. More information about these settings can be found in the Widget Visibility help doc.
CSS Class
In this section, you can add a CSS Class that will be associated with the Entry Display Widget - that way you can target it with custom CSS code. Rules and naming conventions are provided so that you don't use a class that won't work. Simply add your CSS class(es) to the Extra CSS Classes field.
