Groundswell for WordPress

Groundswell Petition

Embed a single petition with full signing capability. Pick a petition from your organization (or enter a slug), choose a layout, and configure display options.

Groundswell Petition List

Display a list of petitions, filtered by category and sorted by recency, popularity, or trending status.

Groundswell Petition Form

Let visitors create new petitions directly from your WordPress site. The block renders a full petition creation form with configurable defaults.

Groundswell Petition Container

Build your own petition layout from only the elements you want, in any order. Pick a petition, then drag in Groundswell Element blocks (title, image, count, progress, form, sign button, decision makers, recent signatures, social, donation, spacer, and more). The petition loads once and is shared by every element inside. Each element — and the container itself — exposes the same Colors and Advanced Appearance panels (presets, fonts, radius, spacing, shadow, and a custom CSS class) as the Groundswell Petition block. The full attribute reference is in the in-plugin How to Use guide and under Container Layout below.

Layout Types

[groundswell type="large-card" slug="save-springfield-park"]

[groundswell type="form-card" slug="save-springfield-park" theme="dark"]

[groundswell type="list" limit="6" sort="trending"]

Common Attributes

Every attribute is optional except a petition reference (slug or id), which is required for every type except list.

Advanced Styling Attributes

Every attribute below is optional and works on the [groundswell] shortcode, the [groundswell-container], and each [gs-el] element. Unset values fall through to the applied preset, then the Style Kit, then the plugin defaults.

A fully-loaded example combining several options:

[groundswell type="form-card" slug="save-springfield-park" description="full" recent-signatures="5" recent-layout="carousel" target="2" target-avatar="true" preset="my-brand" accent-color="#16a34a"]

Donation Shortcodes

Place a Donorbox donation form, or a button that opens one in a modal, on any page. With no slug they use the current Petition Page's campaign.

[groundswell-donate slug="your-campaign"]

[groundswell-donate-button label="Donate" slug="your-campaign"]

[groundswell-donate-button title="Support us" subtitle="Every dollar helps"]

Both donation shortcodes also accept a class attribute to target the embed or button from your own CSS — the same passthrough available on [groundswell], [groundswell-container], and [gs-el].

Container Layout

Build your own petition layout from only the elements you want, in any order. In the block editor, add the Groundswell Petition Container block, pick a petition, then drag in Groundswell Element blocks. Or use the shortcode form — the petition loads once and is shared by every element inside:

[groundswell-container slug="save-springfield-park" max-width="600px" gap="1.5rem"]
  [gs-el type="count" label="people have signed"]
  [gs-el type="progress"]
  [gs-el type="form"]
  [gs-el type="social"]
[/groundswell-container]

Element type values: title, description, image, creator, count, progress, form, sign-button, status, recent-signatures (recent-layout list or carousel), targets (target-layout list or card), donation, social, and spacer. Both the container and each element accept the full styling attribute set of [groundswell]— every color, font, border, radius, shadow and text-shadow option, plus preset(a saved Appearance & Branding preset) and class. On an element they apply to that element only; on the container they set inherited defaults (a container presetapplies to every element, and an element's own values override it). The container also takes layout (column · row · grid), gap, max-width, align, and columns.

Labels on count / progress accept the placeholders {{count}}, {{goal}}, and {{percent}}so you can write your own text — e.g. label="{{count}} people have signed" or label="{{percent}}% of the way there".

The socialelement shares the petition's canonical link — set its base under Settings → Groundswell → Petition site URL.