Skip to main content

mbr_list

Usage

This shortcode subscribes/unsubscribes an ActiveCampaign contact to/from ActiveCampaign lists. The contact is either that linked with the logged in user, or the contact specified.

The shortcode can be run automatically or used to generate a button or link within a page or post that, when clicked, will subscribe/unsubscribe the contact to/from the lists.

Parameters

ParametersDescription
cidThe ActiveCampaign contact ID of the contact to add to or remove from automations.
Defaults: Current logged in user contact ID.
Required: no.
subscribeOne or more list ID's defined within ActiveCampaign to subscribe the contact to. The available lists can be found in ActiveMember360, Utilities, Lists. If more than one is entered, please separate with commas.
Defaults: none.
Required: Yes if unsubscribe parameter not set.
unsubsribeOne or more list ID's defined within ActiveCampaign to unsubscribe the contact from. The available lists can be found in ActiveMember360, Utilities, Lists. If more than one is entered, please separate with commas.
Defaults: none.
Required: Yes if subscribe parameter not set.
unsubscribe_reasonReason for using unsubscribe.
Default: Contact unsubscribed on site
Required: no.
autorunIf set to yes the shortcode will execute without waiting for user input. Otherwise it will generate a form and a submit button or link_style and wait for user input. If set to yes the following parameters will be ignored; link_text, link_style, button_text, button_image, button_style, redirect_popup, aftertext.
Permissible Values: yes
Defaults: none.
Required: no.
link_textThe text to display for the link.
Defaults: Click here to submit
Required: no.
link_styleThe CSS style to apply for the link.
Defaults: mbr_list_link
Required: no.
link_idThe CSS ID to apply for the link.
Defaults: mbr_list_link
Required: no.
link_classThe CSS class to apply for the link.
Defaults: mbr_list_link
Required: no.
button_textThe text to displayin the button.
Defaults: Click here to submit
Required: no.
button_imageThe URL of the image to use for the button.
Defaults: none.
Required: no.
button_styleThe CSS style to apply for the button.
Defaults: mbr_list_btn
Required: no.
button_idThe CSS ID to apply for the button.
Defaults: mbr_list_btn
Required: no.
button_classThe CSS class to apply for the button.
Defaults: mbr_list_btn
Required: no.
redirectThe URL to send the user to after subscribing/unsubscribing the contact to/from the lists. A special value can be passed, #reload#, to force all shortcodes on the page to resolve based on the latest changes that may have been introduced by processing this shortcode.
Defaults: none.
Required: no.
redirect_popupSpecifies whether the user will be redirected to a new window after clicking the link or button. Only used if the redirect parameter is set.
Permissible Values: yes
Default: none.
Required: no.
after_textThe text that should be displayed after the shortcode has been processed, if the user hasn’t been redirected.
Default: Your request was processed
Required: no.

Validity

This shortcode is only processed for logged in users who also exist as contacts within ActiveCampaign.

In all other cases, including WordPress users with the Administrator role nothing will be processed.

Conditional Branching

This shortcode does NOT support conditional branching with [ELSE_list].

Nesting

Shortcode nesting is NOT supported.

Examples

Subscribe the contact linked with the logged in user to the ActiveCampaign lists with IDs 8 and 9 when they click on the link labelled 'Click here'. When processing has completed display reload the current page:

[mbr_list subscribe='8,9' redirect='#reload#' link_text='Click here']

API

Note

There is currently no ActiveMember360 API function equivalent for this shortcode.