Groups are a way of tracking subsets of your supporters who meet certain criteria that set them apart from the rest of the list. These groups can be used as search criteria for queries and for targeting email messages.
Salsa allows you to create as many groups as you like, and each group can contain as many of your supporters as you would like to include. Groups can be used as search criteria for queries and for targeting email messages.
Jump to section:
First, click on the Supporter Management tab. One of the links that appears under the tabs will be Manage Groups--click on this to be taken to the groups management page.
In the lower left hand corner of the groups page, there is a blank field labeled New Group Name. (If you already have a lot of groups set up in Salsa, you may need to scroll down to find this field.) Enter a name for your new group and click the button labeled Create New Group. The page will refresh, and your new group will appear in the list of groups.
To manage group memberships or rename, edit, or delete any of your groups, click on the group name to bring up the group management options. After clicking the name of a group, tabs and information will appear on the right hand side of the group management page. Let's look at what each of the tabs do:
The members tab displays the supporters who are members of this group. You will see the First Name, Last Name, and email address of each group member. By default, the list of members is sorted by the creation date for each supporter record--you can change the sorting criteria by clicking the Sort by drop-down menu on the right hand side of the screen. If there are too many members to display in the area, members will be sorted into multiple pages. Underneath the list of members you will see links to navigate through the pages. You will also see information on the total number of members of this group.
If you click on the name or email address of any member, a new window will open to display that member's supporter record. To the left of each member is a link labeled Remove. If you click on that link, it will remove the supporter from this group. (To remove many supporters from a group at once, use the query tool under supporter management.)
You can quickly add new individual members to the group by entering a supporter's email address in the text field labeled Add supporter by email address and clicking the Add to Group button. If that email address already exists in your system, that person will be added to the group. If you add an email address that does not match up with an existing supporter, the system will create a new supporter record with that email address.
This tab will allow you to change the name of the group, or create a parent/child or group/subgroup relationship with another group. Be sure to hit the Save button each time you make modifications to a group's settings!
Group Name - Change the name of the group by simply typing a new name in the group. No other changes will need to be made.
Choose Item Parent - This feature allows you to create parent/child and group/subgroup relationships. To designate a group as a child (or sub) group, click the Choose Item Parent dropdown and then select an existing group from the list: the current group will become a child/sub to the group you select.
Once a group has been designated with a parent, the parent will appear in the Manage Groups section as a folder, which can be expanded to show a nested list of its child groups:
Additional note:Running a query, but you can't find your child groups in the listing? Only top-level groups are alphabetized in the list: the child groups appear in a sub-list under their parent. (For example: if you're looking for the Volleyball group, you'll find it listed underneath the 2012 Community Teams group, not under "V" in the groups list.)
Description - This is an optional field for a short description of the group.
Notes - This is an optional field to store your notes about this group. This text is only visible internally in Salsa, so if you want to say something unflattering or confidential about a group, this is the place to do it.
Display to user - If you check this box, the name of this group will appear on unsubscribe and supporter profile pages so that your supporters can opt in or out of this group. Leave this box unchecked if you do not want your supporters to be able to add or remove themselves from this group.
Salsa allows you to create email lists which can be used to create more space for your supporters to interact with you and with each other.
A listserve in Salsa is a means of allowing the members of a Group to communicate with each other. They can be open, moderated, or allow only specific members to post to them. The many options available for configuring your listserves are described here.
Listserves are set up through the Manage Groups section under Supporter Management.
Any Group may be used as a listserve. When you name your group, you'll want to keep your group name simple and avoid any "special" characters that wouldn't normally be found in an email address.
All members of your group will be sent listserve messages unless their Supporter record has an Unsubscribed receive email status.
If you're just getting started, we highly recommend creating a test group with a few different email addresses that you can use to make sure your Listserve suits your needs. If you run into any trouble at all, please email support and let us know the internal URL or group_key for the group with which you're working as well as any particular error messages that you're encountering.
For the purposes of Listserves, once you give your group a name, you'll use the Listserve and Options tabs in the group interface to set up your Listserve preferences, and the Recent Listserve Messages tab will be helpful for monitoring what has been sent.
- Open Discussion List: If the list is marked as Open, all members of the group may post and receive messages through the listserve immediately. Open Discussion Lists may not have any moderators listed in “Moderator Emails."
- Moderated List: If a list is moderated, you'll want to add at least one email address for the moderator of the list through the Moderator Emails field. The moderator must also belong to the group.
- Restrict Posts to Allowed Users: If this option is selected, all members of the group will have a menu in their corresponding supporter record under the Groups/Interests tab that will allow you to specify what sort of access they have to the listserve.
Moderator Emails: If entering numerous moderator emails, you'll want to delimit your list with commas. Moderators will be notified via email when a message needs to be moderated. There are two ways to moderate: Moderators can reply to the email message they receive, or they can view the message through the groups interface in Salsa by going to the Recent Listserve Messages tab, clicking the “ID” link for the message, and changing its Status from "Pending" to "Moderated". Once it has finished processing, the message will be marked as "Complete."
Subject Prefix: You may choose to have something like "[Community Listserve]" prepended to the subject lines of emails sent through your listserve.
Append Header: Headers can be automatically appended to emails sent through the listserve. You do not need to use this field.
Append Footer: This is a good place to add a note about unsubscribing from the listserve, but you do not need to use this field, either.
Listserve Email Address: This is the email address to which your listserve messages are sent.
Listserve Options: This field can be ignored.
Aliases: You can set up an alias so that you can send messages to your listserve through a simpler address that is relevant to your organization. Please see “Creating an Alias” below.
Edit Aliases: Click here to edit your aliases. More details on creating aliases are below.
After you save this information, the email address for posting to this group will appear at the bottom of the Listserve tab. It is usually something like: MyGroupemail@example.com, though the domain will change depending on what node your account can be found.
This email address will work to send messages to that listserve, which will then be distributed to all members.
Creating an Alias
The standard listserve domains for Salsa look something like @lists.salsalabs.com. Creating an alias for what comes before this domain is quite easy.
For each of the listserve groups, copy the default listserve address referenced at the bottom of the listserve tab, then click on the "Edit Alias" link. You'll redirect to a new page where you can use the Add Alias button to add another row on the Alias list.
Paste the full default listserve email address into the Real Address field, and type the desired Alias address into the Alias. (As an example, XXXX_Group_Listerve@lists.salsalabs.com would be the default listserve email address, and GroupName@lists.salsalabs.com would be the alias).
For listserve aliases with custom domains, you need to have your domain name server point (as an example):
list.yourdomain.org would point to lists.salsalabs.com
Once that is set up, you can go here to the following page to test to make sure it is set up correctly: http://www.mxtoolbox.com/
Then, for each of the listserve groups, copy the full default listserve address referenced at the bottom of the listserve tab, then click on the "Edit Alias" link. You'll redirect to a new page where you can use the Add Alias button to add another row on the Alias list.
Paste the default listserve email address into the Real Address field, and type the desired Alias address into the Alias. (As an example, XXXX_Group_Listerve@lists.democracyinaction.org would be the default listserve email address, and GroupName@list.yourdomain.org would be the alias).
Set the alias to Active, hit save and you should be all set up from your end.
For the very last step with your custom domain, let us know when this has been done by emailing firstname.lastname@example.org. We'll need to report this to our systems team and make some changes with configuration on our end.
Last Modified: This is the date that the group settings were last changed.
Date Created: This is the date on which the group was initially created.
Reference Name: For internal purposes, only. Does not need to be populated.
Subscription Type: This field can be ignored.
Manager: This field can be ignored.
Listserve Responses: Changing this setting will change from whom the messages appear to be sent when viewed in the recipient's inbox.
- From Sender: Messages will appear to come from whomever submits the listserve message, so when a member of a listserve group sends a message to the group, replies to that message go only to that member.
- Reply-To Sender
You can either use the Listserve Responses options above to set up a general default, or you can set up specifics as follows:
From Email: You can choose to have your emails appear with a distinct "From" email address.
From Name: You can choose to have your listserve emails appear with a distinct "From" name, such as "Community listserve."
Reply to: You can choose to have your listserves default to a particular "Reply to" address. Setting this field to a single email address can be particularly helpful to avoid the sending of "out of office" and other types of autoreplies to the entire list.
To send a Listserve message, you'll use your personal email client to craft your message, then send that message to your listserve address or alias.
Click on the "Send Message" link next to the listserve email or Alias email at the bottom of your Listserve tab. This will open a new window for composing an email from your computer's default email client. As long as you're sending to a valid listserve address from a valid email address that is included in the groups list, you should be able to submit the message without error.
Please note: We do advise that Salsa listserve messages be in plain text only for more efficient processing and increased likelihood of the messages making it to their respective inboxes. We do not recommend sending attachments via Listserve messages. The increased size of the email causes issues with many spam filters.
If you run into any issues, please email support and include reference to any error messages that you may have received.
This tab will show all messages sent. If you are testing sending your listserve messages but they do not show up in this list, there's likely an issue with the message that is prohibiting it from getting to our servers in the first place. Doublecheck that you're sending your message from an email address that is in your group, that you're approved to send messages, and that your message content is relatively straightforward, since very large attachments can cause the message to not send properly.
Clicking on the ID number of the messages in your list will return more detailed information specific to your message, including:
Supporter KEY: for the supporter who sent the message
Date Submitted: This is the date your listserve message was submitted for sending.
Status: Your listserve message will have one of the following statuses:
- New - the email is in the queue but is not yet processing
- Rejected – if for some reason your message could not be sent (common reasons include attachments, images, or MS Word code in the message body), its status will be Rejected.
- Pending Moderation – if the list is moderated, messages will have a status of “Pending” until a moderator sets the status to “Moderated.”
- Moderated – this is the status of a Moderated listserve message that has been approved by a moderator.
- Sending Emails – the message will have this status if the listserve message is in the process of being sent to all the members of the group.
- Complete – this status will appear once the message has been sent to all the group members.
- Failed - the mail server was unable to send your message (possibly due to a server issue).
To: The listserve email address
Subject: The "Subject" line of the listserve message
Content: The content of the listserve message
Result: Displays the number of messages sent successfully and the number of errors.
Supporters can be added to the group either directly through the Salsa interface or through the "Add to groups" functionality on a sign up page or another online form.
Salsa's unsubscribe pages can also allow for unsubscribing from specific groups (as opposed to completely unsubscribing from your overall supporter list). Checking the Display to User option in your groups set-up will allow for the particular group to appear on the default Unsubscribe and Profile Manager pages.
If you have a specific group that will be using your listserve, say board members, then you probably won't need to promote. But, if you're opening a general-interest public listserve to get supporters talking about the issues, you'll want to have a sign up page for the listserve.
- Go to your website tab and create a new Sign Up Page
- Select which info fields you'd like to get from your supporters. Remember, sometimes less is more.
- Write a few sentences explaining for what your supporters are signing up.
- Select the group which you converted into a listserve from the groups dropdown.
- You can either choose to add people automatically to the listserve or have a check box where they select themselves. The latter option is great when you have more than one listserve to join; for the former, make sure that the page adequately describes to the user the fact that s/he will be joining the relevant listserve.
Groups, by default, don't add or subtract their membership except through somebody's manual intervention, either by a campaign manager (you) adding, deleting or importing supporters, or by supporters themselves opting-in or unsubscribing from groups. If you find yourself running the same kinds of queries over and over to add people to groups, why not make the group a smart group and automate the process?
A Smart Group's membership is automatically updated once a day (every 24 hours) according to criteria you specify in advance.
To create a smart group, build and save a named query. Then, select the group and under the "Smart Group Options" tab, check the "smart group" box, select the appropriate query, and save. (You need to have the query defined before you get to this screen.) Smart Groups are also useful when working with data that takes more time to compile, such as action history or email statistics.
Once you've got a Group, you'll need to do two things to change it into a Smart Group:
- Under the specific Group's Smart Group Options tab, set it as a "Smart Group" (or, a "Greedy Smart Group" - see below)
- Still in the same tab, associate the Smart Group with a saved Query .
(Greedy smart groups are just like smart groups - except they only add supporters, never emptying themselves. For most purposes, we recommend regular, non-greedy Smart Groups.)
Tip: Smart groups can be a handy tool for giving local organizers access to a dynamically updating roster of people in just their region. Just create a role limiting that user to the membership of a smart group, then have the smart group run a query such as a single state or a postal code radius. Presto--no more emails saying "Hey, could you export me another list of all the people in my district?"
Rather than making a really complicated smart group that covers every possible supporter in a manager's district, though, keep the smart groups simple, then add child groups with manually added supporters that might not match the query. Read more about smart groups.
A regular smart group will automatically empty itself once every 24 hours, then repopulate itself with your saved query. "Greedy" smart groups are just like smart groups -- except they only add supporters, never emptying themselves.
A smart vs. greedy smart group example: Say that you're constantly importing supporters to your database, and you want use smart groups to automatically add everyone from Hawaii to a group. A standard smart group (set to use a query that finds every supporter who lives in Hawaii) will add everyone in your database who lives in Hawaii to the group. However, suppose a supporter moves from Hawaii to Alaska, and her supporter record is updated accordingly. A smart group would remove her from your Hawaii group, the group empties itself and then adds people who live in Hawaii--since her record changed, she wouldn't be re-added at the next update. A "greedy" smart group will greedily hold on to this supporter and any others who leave Hawaii, and only adds new members instead of removing those that no longer match your query. This might be helpful, for example, if you want to give people the option to continue in a group that follows a local issue even if they move away from an area.
How about a quick story demonstrating the difference between smart groups and greedy smart groups? Check out the image below (click to enlarge):
If you're not sure or just starting out with smart groups, we recommend sticking with regular, non-greedy smart groups. You generally need a good reason for keeping people in a group who don't match the group criteria, and you can get stale or incorrect data if you're not careful.
Tip: Greedy smart groups can send autotriggers emails when new members are added. So if you want to make sure that people in a certain group always receive a welcome message, it's easy set that up. Read more about setting up autotriggers with smart groups.
Should you use groups or tags? As a rule of thumb, if your need is to manage people (and only people), use groups. If you need to manage any other data-- instead of people, or in addition to them--use tags. Because of some of the specific features of groups (smartgroups, listservs) and tags (attach to any object/page in Salsa), you might find yourself gravitating towards using them for certain kinds of data: