Answers.Body: <p>There is no built-in &quot;Unsubscribe All&quot; function in CiviCRM, though there is a <em>User Opt Out</em> option from CiviMail, as well as a <em>Do Not Email</em> setting.</p>
  <h3>Unsubscribe</h3>
  <p>The unsubscribe link is provided by the <code>{action.unsubscribeUrl}</code> (URL) or <code>{action.unsubscribe}</code> (email) <a href="http://wiki.civicrm.org/confluence/display/CRMDOC/Tokens" rel="noreferrer">tokens</a>.</p>
  <p>The unsubscribe email, even if not provided as a token in the message, is supplied in the email headers as the <em>List-Unsubscribe</em>  address. Someone who unsubscribes by email is removed from <a href="https://forum.civicrm.org/index.php?topic=19080.0" rel="noreferrer">every list</a> used to send the message. For example, if you send a newsletter to two groups, <em>Donors</em> and <em>Volunteers</em>, and joe@example.net is on both, Joe would no longer receive messages from either <em>Donors</em> or <em>Volunteers</em>.</p>
  <p>More commonly, people would click on the unsubscribe link, and be brought to a confirmation page to be asked</p>
  <blockquote>
  <p>Are you sure you want to be removed from the mailing list(s) shown below …</p>
  <p>You are requesting to unsubscribe this email address</p>
  </blockquote>
  <p>The confirmation is in place to prevent accidental removals when people follow the link from forwards or replies. If confirmed, the contact is not deleted from the Group, but their group status is changed to <em>Removed</em>.</p>
  <p>As of 4.6.5, there appears to be no way to unsubscribe from <em>all</em> groups at once, nor even to pass individual group IDs to the unsubscribe, unlike subscribing where group IDs can be passed to <code>{action.subscribeUrl}</code> as <code>{action.subscribeUrl.gid}</code>. On Drupal, it might be possible to handle subscriptions using <a href="https://www.drupal.org/project/webform_civicrm" rel="noreferrer">Webform CiviCRM Integration</a> and a bit of jQuery to select/unselect multiple checkboxes.</p>
  <p>Because unsubscriptions are on a list-by-list basis, people unsubscribing from all current lists would not prevent them from being added to any newly created lists.</p>
  <h3>Opt-out</h3>
  <p>In contrast to the unsubscribe options, a user <em>Opt Out</em> (<code>{action.optOutUrl}</code> or <code>{action.optOut}</code> tokens) does not affect group membership status; it is an independent field on the contact itself. Contacts which have <em>NO BULK EMAILS (User Opt Out)</em> selected will be removed from <em>all</em> CiviMail mailings. So if you add the contact to any new mailing lists you create in the future, they will not receive messages from those lists, either.</p>
  <p>The confirmation message for an opt-out link is different from that of an unsubscribe link:</p>
  <blockquote>
  <p>You are requesting to opt out this email address from all mailing lists</p>
  </blockquote>
  <p>There is no way to prevent an opt-out, though that <a href="https://issues.civicrm.org/jira/browse/CRM-16062" rel="noreferrer">feature has been requested</a> in the past.</p>
  <h3>Do Not Email</h3>
  <p>A third option, which I believe can only be set by an admin or through a custom setup, not only prevents the distribution of CiviMail to a contact, but prevents an admin from sending a direct message as well.</p>
  
Answers.ContentLicense: CC BY-SA 3.0
Answers.CreationDate: 2015-08-06T00:06:26.447Z
Answers.LastActivityDate: 2015-08-06T00:06:26.447Z
Answers.LastEditDate: 2020-06-17T09:00:50.810Z
Answers.UserDisplayName: choster
Answers.Body: <p>There's four tokens that are relevant to what you're asking.  Unsubscribe via e-mail, unsubscribe via web, opt-out via e-mail, opt-out via web.</p>
  
  <p>Opt-out will opt someone out of all future mailings.  Unsubscribe via web SHOULD allow someone to pick which group(s) they're unsubscribing from.  If that's not your experience, please update the question to explain what it's not allowing you to do.</p>
  
Answers.ContentLicense: CC BY-SA 3.0
Answers.CreationDate: 2015-08-05T23:46:32.587Z
Answers.LastActivityDate: 2015-08-05T23:46:32.587Z
Answers.UserDisplayName: Jon G - Megaphone Tech
Body: <p>When recipients click "Unsubscribe" in my mailings, it takes them to a page where they can unsubscribe from every group the mailing was sent to. Is there a way to let them opt-out of one and not the other, and also is there a way to let them opt-out of all future mailings? Sorry if this is listed somewhere. I've searched and looked in the docs but haven't come across this.</p>
  
Comments.ContentLicense: CC BY-SA 3.0
Comments.CreationDate: 2015-08-06T22:05:55.273Z
Comments.Text: Thank you for educating me on Unsubscribe vs. Opt Out. In my mail footer I had been using only {action.unsubscribeUrl}. Now I have added {action.optOutUrl} as a means of letting them opt out of all future mailings, which is the feature I was looking for. 
  
  I'm still not able to figure out how to get {action.unsubscribeUrl} provide the option to select which list to unsubscribe from if the user is in more than one that the mailing was sent to. 
  
  Thank you again for this help. Clearly I'm the front end user trying to figure out my own setup. Yikes.
Comments.UserDisplayName: Emily
Tags: <civimail><email>
Title: How can I provide mailing receipients an "Unsubscribe All" option?
ThreadText: # How can I provide mailing receipients an "Unsubscribe All" option?
  
  (Asked by: username_0 on 2015-08-05)
  
  When recipients click "Unsubscribe" in my mailings, it takes them to a page where they can unsubscribe from every group the mailing was sent to. Is there a way to let them opt-out of one and not the other, and also is there a way to let them opt-out of all future mailings? Sorry if this is listed somewhere. I've searched and looked in the docs but haven't come across this.
  
  **Tags:** civimail, email
  
  > **Comments:**
  > **username_0**: Thank you for educating me on Unsubscribe vs. Opt Out. In my mail footer I had been using only {action.unsubscribeUrl}. Now I have added {action.optOutUrl} as a means of letting them opt out of all future mailings, which is the feature I was looking for.   I'm still not able to figure out how to get {action.unsubscribeUrl} provide the option to select which list to unsubscribe from if the user is in more than one that the mailing was sent to.   Thank you again for this help. Clearly I'm the front end user trying to figure out my own setup. Yikes.  
  
  ---
  
  ## 2 answers
  
  ### Answer by username_1 on 2015-08-06. Score: 12
  
  There is no built-in "Unsubscribe All" function in CiviCRM, though there is a *User Opt Out* option from CiviMail, as well as a *Do Not Email* setting.
  
  ### Unsubscribe
  
  The unsubscribe link is provided by the `{action.unsubscribeUrl}` (URL) or `{action.unsubscribe}` (email) [tokens](http://wiki.civicrm.org/confluence/display/CRMDOC/Tokens).
  
  The unsubscribe email, even if not provided as a token in the message, is supplied in the email headers as the *List-Unsubscribe* address. Someone who unsubscribes by email is removed from [every list](https://forum.civicrm.org/index.php?topic=19080.0) used to send the message. For example, if you send a newsletter to two groups, *Donors* and *Volunteers*, and joe@example.net is on both, Joe would no longer receive messages from either *Donors* or *Volunteers*.
  
  More commonly, people would click on the unsubscribe link, and be brought to a confirmation page to be asked
  
  > Are you sure you want to be removed from the mailing list(s) shown below …
  >
  > You are requesting to unsubscribe this email address
  
  The confirmation is in place to prevent accidental removals when people follow the link from forwards or replies. If confirmed, the contact is not deleted from the Group, but their group status is changed to *Removed*.
  
  As of 4.6.5, there appears to be no way to unsubscribe from *all* groups at once, nor even to pass individual group IDs to the unsubscribe, unlike subscribing where group IDs can be passed to `{action.subscribeUrl}` as `{action.subscribeUrl.gid}`. On Drupal, it might be possible to handle subscriptions using [Webform CiviCRM Integration](https://www.drupal.org/project/webform_civicrm) and a bit of jQuery to select/unselect multiple checkboxes.
  
  Because unsubscriptions are on a list-by-list basis, people unsubscribing from all current lists would not prevent them from being added to any newly created lists.
  
  ### Opt-out
  
  In contrast to the unsubscribe options, a user *Opt Out* (`{action.optOutUrl}` or `{action.optOut}` tokens) does not affect group membership status; it is an independent field on the contact itself. Contacts which have *NO BULK EMAILS (User Opt Out)* selected will be removed from *all* CiviMail mailings. So if you add the contact to any new mailing lists you create in the future, they will not receive messages from those lists, either.
  
  The confirmation message for an opt-out link is different from that of an unsubscribe link:
  
  > You are requesting to opt out this email address from all mailing lists
  
  There is no way to prevent an opt-out, though that [feature has been requested](https://issues.civicrm.org/jira/browse/CRM-16062) in the past.
  
  ### Do Not Email
  
  A third option, which I believe can only be set by an admin or through a custom setup, not only prevents the distribution of CiviMail to a contact, but prevents an admin from sending a direct message as well.
  
  
  ---
  
  ### Answer by username_2 on 2015-08-05. Score: 5
  
  There's four tokens that are relevant to what you're asking. Unsubscribe via e-mail, unsubscribe via web, opt-out via e-mail, opt-out via web.
  
  Opt-out will opt someone out of all future mailings. Unsubscribe via web SHOULD allow someone to pick which group(s) they're unsubscribing from. If that's not your experience, please update the question to explain what it's not allowing you to do.
  
  
  ---
  
  