Promoted petitions ensure that your supporters see the campaigns you want them to.
The feature has two main pieces: home page petitions and daisy chain (after-signing) petitions. Both sets of petitions are chosen by admins to be visible to supporters. Promoted petitions allow your organization to highlight the work you're doing and your most important campaigns.
Promoted petitions are visible from the org admin homepage > Settings > Promoted, and admins can designate new promoted petitions from the same page. Petitions can also be promoted by going to the petition's Admin > Details page.
Home Page Petitions
The Petitions Promoted on Home Page tool allows org admins to control which petitions are included in the featured campaigns section of the organization's home page.
On Settings > Promoted > Petitions Promoted on Home Page, org admins can see the currently promoted petitions and update or rearrange the campaigns that are shown.
Please note: the featured campaigns section of the home page includes a maximum of three petitions – we'll show the three campaigns at the top of this list on the home page.
For organizations operating in more than one language, we'll show any promoted petitions matching the user's language first, even if there are other petitions in other languages higher up in the list. If there aren't at least three petitions in the user's language, we'll add petitions from the organization's default language to the bottom of the featured campaigns section.
You can add a new petition to the home page from this promoted petitions page or from the petition's admin page.
To feature a new campaign from the promoted petitions page, click the Add button and complete the petition's URL. You can also add a petition to the home page by going to the petition's admin page and scrolling to the Campaign Status section. Once you click the + button in this section, you'll be redirected to the promoted petitions page, where you can rearrange the featured petitions.
Once a petition has been added to the promoted home page petitions list, you can rearrange its position using the up and down arrows or by clicking and holding its gray box and dragging it to its desired position. To remove a petition from the promoted petitions list, click the X box.
Daisy Chain (after-signing) Petitions
Daisy chain promoted petitions allow org admins to include information about other petitions in the after-signing daisy chain. The feature supports both Global and Local promoted petitions. Global promoted petitions will be promoted to anyone who takes action on the site (if they haven't already signed the campaign) and local promoted petitions will only be shown to signers who are within a 10km radius of the petition's location.
To start using this feature, go to the promoted petitions page, click to Add a petition under the Petitions Promoted on Daisy Chains section, and complete the URL of the petition you want to promote.
You can also add a petition to the promoted petitions list from the petition's admin page.
Once a petition is added to the promoted petitions list, you can also choose whether to make the petition local – only promoted to signers within 10km of its location. To do so, click the Make local button or toggle the local switch on the petition's admin page.
You can also restrict the petitions to certain labels only. (This means that when looking for a petition to promote to a recent signer, we'll skip the petition unless there's a label in common between the just-signed petition and promoted petition.)
Once you've added the petitions you'd like to promote, you need to add the promoted petitions step to the after-signing daisy chains. You can choose to add the promoted petitions modal to all campaigns, only to certain campaigns, or via a URL parameter.
To add promoted petitions to the after-signing daisy chain for all campaigns, go to the admin homepage > Settings > Post Action Flow and click to add a New Post Action Flow Rule.
You'll probably want to base the new rule on the petition's moderation status. Then, choose the moderation statuses that should show promoted petitions. Finally, choose Share, then Promoted Petition. Once you click to Save the list of rules will be updated. You can then rearrange the after-signing rules to get the desired effect.
If you'd like to only enable the promoted petitions modal for certain petitions on an individual basis, go to the petition's Admin page > Settings > After Signing section. Then, click to Override default post-signing settings. Choose Share, then Promoted Petition will add the promoted petition modal to the after-signing daisy chain.
Once promoted petitions are set up for some or all campaigns, signers will see the promoted petition modal after they sign the campaign. The campaign featured in the modal will be randomly chosen from the list of promoted campaigns (unless there are local campaigns near the signer's location), with a preference for petitions with the most categories in common.
The modal includes text pieces that can be set from Settings > Content > Petitions > Title for promoted petition modal or Text for promoted petition modal. You can use email variables in these text pieces. Additionally, the modal will automatically include the petition's title, why text, and progress bar. If the user isn't interested in signing this petition, they can click a link to see a different petition (for a maximum of five promoted petitions). If the user clicks to sign the petition, their signature information will pre-fill and the user will be able to one-click sign the petition.