--- title: "SMS Subscriptions" slug: "sms-subscriptions" updated: 2026-04-23T17:30:03Z published: 2026-04-23T17:30:03Z canonical: "guide.mogli.com/sms-subscriptions" --- > ## Documentation Index > Fetch the complete documentation index at: https://guide.mogli.com/llms.txt > Use this file to discover all available pages before exploring further. # SMS Subscriptions SMS subscription opt-ins and opt-outs are available at the Gateway level in Mogli SMS version 5.49.14 and beyond. For example, if a recipient texts an [opt-out keyword](/user-guide/docs/sms-subscriptions#sms-subscriptions-optin-optout-keywords) such as *STOP,* the customer will only be opted-out from the Gateway in Salesforce that they texted the keyword. ## Global Opt-Out All existing functionality using the record-level Mogli Opt Out checkbox field will continue to work. If you are a current client and have custom automation using the Mogli Opt Out checkbox field, your automation will continue to work as intended. If you would like to migrate your legacy data to show on SMS subscriptions, contact Mogli Tech Support for further assistance via help@mogli.com. ## SMS Subscriptions Opt-In Modes There are two opt-in modes that can be configured in Mogli’s Application Settings: ### Default opt-in mode All phone numbers are considered opted-in until an opt-out keyword is received or the phone number is manually opted-out by a user in Salesforce. To configure default opt-in mode, leave the **Mandatory Opt-in** and **Create Opt-in for Incoming SMS** checkboxes unchecked in the Mogli SMS Application Settings. ![](https://cdn.document360.io/aabde203-b6df-4543-b557-999d7d8b937a/Images/Documentation/image-1685476141960.png) ### Mandatory opt-in mode All phone numbers are considered opted-out until opt-in criteria are met. Opt-in criteria may be specific to your business needs. To configure mandatory opt-in mode, select the **Mandatory Opt-in** checkbox in the Mogli SMS Application Settings. ![](https://cdn.document360.io/aabde203-b6df-4543-b557-999d7d8b937a/Images/Documentation/image-1685478333787.png) Opt-ins can be handled manually within the Conversation View, configured to automatically opt-in a phone number when it sends an incoming SMS, or by custom automation (workflow/process builder/flow). ## Create Opt-in for Incoming SMS Mandatory opt-in mode has an additional option to automate opt-in. Create Opt-in for Incoming SMS. When this option is enabled, anytime there is an incoming SMS that is not already opted-in, that phone number will be opted-in to the Gateway which it is received. To configure automated opt-in, select the Create Opt-in for Incoming SMS checkbox in the Mogli SMS Application Settings. ![](https://cdn.document360.io/aabde203-b6df-4543-b557-999d7d8b937a/Images/Documentation/image-1685478450244.png) Note: If you are upgrading from a previous version of Mogli SMS and you do not see these fields in the Application Settings, your admin will need to manually add these fields to the Application Settings Page Layout. For more information on customizing page layouts, see this [Salesforce Trailhead: Customize Record Details with Page Layouts](https://trailhead.salesforce.com/content/learn/modules/lex_customization/lex_customization_page_layouts). ## SMS Subscriptions Opt-In / Opt-Out Keywords Opt-in/opt-out keywords are stored on the Gateway record, and default values are set based on the Gateway’s messaging partner. Talk to your Mogli AE about setting up custom opt-in/opt-out keywords. ![](https://cdn.document360.io/aabde203-b6df-4543-b557-999d7d8b937a/Images/Documentation/image-1685478924148.png) ## SMS Subscriptions on the Conversation View To access the SMS Subscriptions, click the highlighted button on the Conversation View. ![](https://cdn.document360.io/aabde203-b6df-4543-b557-999d7d8b937a/Images/Documentation/Screenshot 2026-01-02 at 10.30.41 AM.png)![](https://cdn.document360.io/aabde203-b6df-4543-b557-999d7d8b937a/Images/Documentation/Screenshot 2026-01-02 at 10.31.52 AM.png) You will see a list of Gateways that your user has access to, the opt-in/opt-out status & details, and a button to manually opt in or opt out on that Gateway. Opt-in/opt-out statuses include: - *Opt-In* - *Opt-Out* - *No Opt-In* (only shows when Mandatory Opt-in mode is enabled) - Opt-in/opt-out details include: - *Manual opt-out/opt-in by * - *Opt-in/Opt-out keyword: * - *Opt-in from incoming SMS* Note: Custom opt-in descriptions can be configured via custom automation (workflow/process builder/flow). The Opt-In and Opt-Out buttons on the Conversation View allow you to manually opt-in/opt-out phone numbers. ![](https://cdn.document360.io/aabde203-b6df-4543-b557-999d7d8b937a/Images/Documentation/Screenshot 2026-01-02 at 12.13.27 PM.png) IMPORTANT: If a phone number has texted an opt-out keyword, such as *STOP*, a user cannot manually opt in. To opt in, the phone number must text an opt-in keyword, such as *START* or *UNSTO*P. ![](https://cdn.document360.io/aabde203-b6df-4543-b557-999d7d8b937a/Images/Documentation/Screenshot 2026-01-02 at 12.13.52 PM.png) When a phone number is opted-out of a Gateway selected in the Conversation View (or not opted in when using mandatory opt-in mode), you will see a warning message at the top of the Conversation View, and all fields except the Gateway picklist will be disabled. ![](https://cdn.document360.io/aabde203-b6df-4543-b557-999d7d8b937a/Images/Documentation/Screenshot 2026-01-02 at 10.47.42 AM.png) If you are sending via the Bulk SMS Lightning tab, or via a custom automation, the SMS record will be created with SMS.Status = *Error*, and SMS.Debug = *Previous Opt-out* (or *No Opt-In when* using mandatory opt-in mode). ![](https://cdn.document360.io/aabde203-b6df-4543-b557-999d7d8b937a/Images/Documentation/image-1685478781551.png) Global opt-outs (selecting the Mogli Opt-Out checkbox on a Contact, Lead, Opportunity, or custom object record) override SMS Subscription preferences. - When using the Bulk SMS Lightning tab, records with the global Mogli Opt Out checkbox will not be added to the recipient list. - When sending an SMS via custom automation, the automation MUST evaluate the global Mogli Opt Out checkbox, or the message will be sent. ![](https://cdn.document360.io/aabde203-b6df-4543-b557-999d7d8b937a/Images/Documentation/Screenshot 2026-01-02 at 10.49.19 AM.png) ##