How Do I Wagtail?

How Do I Wagtail?


Create a Campaign page

Inside the existing pages, navigate to Campaigns and add a child "campaign" page.

Screenshot of the Wagtail admin campaigns page

Populate this campaign page with content, petition, and fundraising modals as necessary.

To add additional pages to the campaign, add child "Campaign" pages to the original one. The secondary navigation will appear and the initial page will be listed as "Overview", while the label for the remaining pages will come from the page title.

CTA (Petition Form)

In order for petition form to show up on the Campaign Page, you will need to select a Petition Snippet for the Cta field. You can choose from existing Petition Snippets or create a new one.

If you would like to go to a more advanced editing interface for Petition Snippets, you can do so by going to the all "Petition Snippets" list.

Where can I find the all "Petition Snippets" list?

  1. Click on "Snippets" on the left sidebar on the CMS edit interface
  2. Choose "Petition snippets"

Edit existing Petition Snippet

  1. Simply select the Petition Snippet you want to edit on the "Petition snippets" list.
  2. Edit the Petition Snippet

Create a new Petition Snippet

  1. On the "Petition snippet" list page, click on the "Create petition snippet" button (located at top right of the page)
  2. Fill out the fields there

Share Progress

We use Share Progress for social content management and AB testing share messages.

  1. Go to
  2. Get auth credentials from 1Password.
  3. Click "Share Buttons". These are all the buttons we've created, three for each campaign, 1 for facebook, twitter and email.
  4. You need to either create a new one, or copy existing ones and change it.
  5. Click edit on the buttons and update the fields for the button or clear them in the case of a copy and content to be added later.
  6. There should be a six digit id for each button preceded with "sp_". You can get it from the info button for each button, but also get it from the url while editing the button, just make sure if you get it from the url add "sp_" to it, example "sp_189307"
  7. Added these buttons to the wagtail edit page for the petition widget.

Template and more instructions here.


We highlighted below 4 important steps that should be checked out before publishing a petition:

  1. A Salesforce Campaign ID is entered. The campaign must first be created by someone in Salesforce. If you do not provide a Salesforce Campaign ID, your petition signings will be lost forever. Changes will be made soon to require this field before saving.
  2. Check if page has a web graphic: having an image makes the petition more interesting and it may motivate people to participate.
  3. Share Progress images: when a visitor signs the petition and clicks the Share Progress button, in some cases the image that gets shared on their social feed gets pulled from Share Progress. Because of this, the graphic needs to be added in that admin site as well.
  4. "Promote" tab metadata (for Twitter/FB sharing) on Campaign Page: adding info and image to this tab makes the content better for social media.
Promote tab
Screenshot of Promote tab