Skip to content

Grouperly on your group's own website

If your group has a website of its own, such as WordPress, Squarespace, Wix or one somebody built, pieces of Grouperly can sit in its pages. You enter an event or a form once, in Grouperly, and your site shows it.

Your group needs a public page first. The pieces show what that page was last published with.

In Settings → Public page → On your own site, copy the script and paste it once into your site, in the page’s head or body. Then paste the code for each piece where it should go. The same screen has a preview of every piece.

<grouperly-events group="pack1232"></grouperly-events>

group is your group’s page address.

Piece Code What it shows Plan
Follow <grouperly-follow> A Follow button and how many followers you have Free
Request to join <grouperly-join> A button to ask to join. Nothing while requests to join are off Free
Keep me posted <grouperly-subscribe> A form: an email address, and what they’d like to hear about Free
Coming up <grouperly-events> Your next public events Free
Newsletter <grouperly-news> Your newsletter’s latest posts Free
Alumni <grouperly-alumni> A form for people who used to be in your group Free
Contact us <grouperly-contact> Your Contact us forms. Nothing while Contact us is off Plus

Follow and Request to join open Grouperly in a new tab, since they need an account. The forms stay on your site.

Someone gives their email address, ticks I’m 18 or older, and confirms from an email. Nothing is kept until they confirm. They aren’t asked for a date of birth.

Things to tick. Beside your newsletter, the form offers each recurring event you chose to offer, such as your Pinewood Derby. To offer one, open the recurring event, and under Interested people tick Keep a list… and then Offer it on our page and website. See Interested people.

For a page about one event, you needn’t write the code yourself: on that recurring event, Interested people → Put it on your own site has it ready to copy.

Each page can offer something different:

Add to the code What it does
lists="pinewood-derby" Offers only that event, already ticked, with your newsletter as an extra tick. The name is the event’s name in small letters with hyphens. Separate several with commas
lists="" Offers no events: the newsletter alone
news="off" Leaves the newsletter out, for a page about one event
joining="off" Leaves out We’re thinking about joining, which shows only on Grouperly Plus
<grouperly-subscribe group="pack1232" lists="pinewood-derby"></grouperly-subscribe>

If you rename a recurring event, its name in lists changes too.

Every email they get has a link to change what they hear or stop. See Unsubscribe, or get less.

  • limit="3" sets how many to show. Coming up shows 5 and Newsletter 3 unless you say.
  • series="…" on Coming up shows one recurring event’s dates only.

A calendar to subscribe to. Your public events are also at https://www.grouperly.com/<your address>/calendar.ics. Anyone can add that address to their calendar app, with no account.

For whoever builds your site: the same information is at https://www.grouperly.com/<your address>/data.json, for a site that would rather draw its own calendar. It carries up to 50 events, each with its start, end, time zone and recurring event. Its v is 1, and new fields may be added.

You list events publicly for different reasons, and you may not want everything about each one in public, such as exactly where and when children will be. Two choices decide what shows: one on each event, and one for your whole group.

On each event. Open the event, press Edit event, and choose under On the group’s public page:

Choose People outside your group see Good for
Not shown Nothing Events for your members
Name, date and time only The name, date and time, marked Members only, with a link members sign in to open A glimpse of what you do
Full details The date, time, location and description Meetings visitors are welcome at
  • To let anyone sign up, choose Full details, then open Share on the event and press Create a link. Coming up then shows Details and sign-up. See An event’s link.
  • To invite only some people, create the link and send it yourself. On an event that’s Not shown or Name, date and time only, the link is never published.
  • A recurring event’s next date keeps the choice of the one you plan it from, so you don’t set weekly meetings each week. It shows once you plan it.
  • Events you listed before this choice existed show full details until you change them.

For your whole group. This sets the most any event shows, even one at Full details.

  1. Open Settings → Public page.
  2. Under Public events, untick what no event should show: Date, Time, Location, Description or Link to its sign-up page.
  3. Press Save. Your page and your site update within a few minutes.

An event’s name always shows. Everything is ticked until you change it.

You untick People outside your group see
Time The day only: “Saturday, October 17”
Date The times only: “9:00 – 11:30 AM CDT”. The calendar to subscribe to then has no events
Date and Time Nothing about when
Location No place
Description No description
Link to its sign-up page No link to the event’s own page
  • It’s one choice for everywhere outside your group: Coming up on your site, your group’s page on Grouperly, the calendar to subscribe to, the information for whoever builds your site, and Coming up in the newsletter to followers, prospects and alumni.
  • What you leave out isn’t sent at all. It isn’t hidden on the screen and still there underneath.
  • Members see every detail in Grouperly, as before.
  • An event’s sign-up page says when and where it is to anyone who opens it. If you leave out the date, time or location, untick the link too, unless you want anyone to be able to sign up. You can still send the link to the people you choose.
  • A description shows as you wrote it. Check yours don’t say what you’re leaving out.

On Grouperly Plus. See Contact us forms for the forms themselves. On your site:

Add to the code What it does
form="join" Shows your joining form. Any form’s short name works: form="popcorn"
forms="join,question" Lets visitors pick among those forms only
selected="popcorn" Starts on that form, and visitors can still change it. So does ?topic=popcorn added to the address of the page on your own site that holds the form. (On Grouperly’s own Contact us page it’s ?form=popcorn)
source="our Join page" Says where the form sits, shown on each prospect it brings

<grouperly-alumni> is a form for people who used to be in your group. See Alumni who say who they are.

Keep me posted, Contact us and Alumni wait for an email: nothing is kept, and nothing reaches you, until the person confirms it’s them. So once they send the form, it gives way to a yellow box that’s hard to miss, on your own site and on your group’s page alike. The page moves to it, so it’s in view even after a long form. It says:

  • what hasn’t happened yet, such as Your message isn’t sent yet or You’re not signed up yet;
  • the address the email went to, and that its subject starts with “Confirm”;
  • what to press, in the email and then on the page it opens;
  • what they’ll miss until they do, such as Pack 1232 won’t get your message;
  • where else to look: their spam or junk folder, if nothing comes in a few minutes. The link works for 3 days.

Wrong address? Change it brings the form back, with what they wrote, to fix the address and send it again.

Form What they press
Contact us Confirm my message in the email, then Send it on the page it opens
Keep me posted Yes, keep me posted in the email, and again on the page it opens
Alumni Yes, that’s me in the email, and again on the page it opens
Next year’s …, on an event’s own page Yes, tell me in the email, then Yes, keep me posted on the page it opens

An address that’s on your Keep me posted list already gets no email, so nobody can find out from the form who’s on it. The box says so: unless it’s on Pack 1232’s list already.

The box keeps its own yellow on any site, light or dark, whatever your colours.

A tracked link from Recruiting can open a page of your own site, and still count. See Links with QR codes.

Anything you put inside an element shows until the piece does, and stays if it never has anything to show: your group has no page yet, Contact us is off, or Grouperly can’t be reached.

<grouperly-contact group="pack1232">
<a href="mailto:info@pack1232.example">Email us</a>
</grouperly-contact>

So a visitor never meets an empty space. For whoever builds your site: the element has data-state="ready" or data-state="empty", and sends a grouperly-ready or grouperly-empty event.

The pieces take your site’s font and text colour. Set their colours in your site’s stylesheet, on the page or on any element around them:

:root {
--gp-brand: 0 63 135;
--gp-accent: #fdc116;
--gp-accent-ink: #002a5c;
}
Name What it colours
--gp-brand Links and outlines, as three numbers for red, green and blue
--gp-accent Buttons. Your brand colour unless you set it
--gp-accent-ink The words on a button. White unless you set it

If your site has a Content-Security-Policy

Section titled “If your site has a Content-Security-Policy”

Most sites don’t. If yours does:

  • allow https://www.grouperly.com in script-src, connect-src and style-src;
  • allow https://app.grouperly.com in connect-src too, for the forms.

The pieces use no inline styles.