# Choose how Releva manages subscriptions

> Set Subscription Management to Internal or External, choose whether sign-up forms wait for an email confirmation, and define the subscriptions your customers can see.

The **General** tab of **Settings › Messaging** decides who owns your customers’ consent (Releva or your shop), what happens when a customer fills in a sign-up form, and which subscriptions appear in the subscription manager your customers see. Set it once when you connect your shop, and review it before you launch a new sign-up form.

## Before you start

* You know whether your shop keeps its own record of who is subscribed. If it does, pick **External**; if Releva is the only place you send marketing from, pick **Internal**.
* If your integration sends subscriptions, have the exact keys it uses to hand. Your developer can find them in the integration’s code.
* Changes apply to the whole shop as soon as you save them.

## Steps

1. Open **Settings › Messaging**. The **General** tab opens.

   The subscription settings are in the card below **Max Messages Per Day** and **Click Tracking**. The screenshots leave out the **Click Tracking** card, which belongs to sending setup, not to consent.

   ![Step 1](https://releva.ai/documentation/_astro/step-1.D603980s_Z1LF3a5.webp)

2. Under **Subscription Management**, select **Internal** if Releva keeps your subscribers, or **External** if your shop does.

   | Mode         | What it means                                                                                                                                                                                                                                                                                         |
   | ------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
   | **Internal** | Releva stores consent. Unsubscribe links in messages open Releva’s **Subscription preferences** page, every profile page has a **Subscribe** / **Unsubscribe** button, and the settings below appear. Send email and SMS only through Releva, because unsubscribes do not propagate to other systems. |
   | **External** | Your shop stores consent. Emails link to your **Email Unsubscribe URL** (or to the per-profile link your integration sends), and your shop must tell Releva about every opt-out. The **Subscriber Sync API** field lets Releva pull your subscriber list from a URL you implement.                    |

   ![Step 2](https://releva.ai/documentation/_astro/step-2.DyXjkfL__Z1hewtX.webp)

3. With **Internal**, choose whether sign-up forms **Wait for confirmation** by email or **Subscribe right away**.

   This setting is labelled **Subscription Request Behavaior** in the current UI. It applies to sign-ups from your site, such as Releva forms and banners and your own sign-up forms:

   * **Wait for confirmation**: the customer is not subscribed yet. Releva records a **Subscribe Request Submitted** event, which you use to trigger a workflow that sends a confirmation email with the `{{subscribeLink}}` merge tag. The customer is subscribed when they open the link (double opt-in).
   * **Subscribe right away**: the customer is subscribed immediately. Easier, but anyone who copies your shop’s public access token can subscribe any address, so consider a welcome email with an unsubscribe link.

   Subscribing from the admin, or from your shop’s server, always subscribes right away, whatever this setting says.

   ![Step 3](https://releva.ai/documentation/_astro/step-3.qnXMPFb-_ZzvMEf.webp)

4. Under **User Visible Subscriptions**, switch on the subscriptions your customers can see and unsubscribe from.

   Each row is a subscription key known to your shop. **Visible to users** puts it in the subscription manager; **Name shown to users (optional)** replaces the key with a caption. **Marketing** is the shop-wide opt-in and is listed first; you can hide it only while at least one other subscription is switched on.

   What you switch on here also decides what an unsubscribe removes: only user-visible subscriptions are cleared, subscriptions set through the API and never shown stay on the profile.

   ![Step 4](https://releva.ai/documentation/_astro/step-4.DYzLGr3A_coCGz.webp)

5. To add a subscription, type its key.

   Type it in the field with the placeholder `e.g. weeklyNewsletter`. If your integration sends subscriptions, match its key exactly; if not, the key is yours to choose.

   ![Step 5](https://releva.ai/documentation/_astro/step-5.DXvoufq6_dTk7e.webp)

6. Select **Add subscription**.

   The new row appears switched on, with a caption derived from the key (`vipEarlyAccess` becomes **VipEarlyAccess**). Pressing Enter in the field does the same. Once saved, the key is also available in segment rules, catalog triggers and workflows.

   ![Step 6](https://releva.ai/documentation/_astro/step-6.k0mppwQW_Wuyv7.webp)

7. Select **Save**.

   The button reads **Saved** and is disabled until you change something else. Leaving the page without saving discards your edits.

   ![Step 7](https://releva.ai/documentation/_astro/step-7.DPGH1yQS_WTl01.webp)

> **For developers**
>
> The calls your integration needs in each mode are in [Choose a consent call](https://releva.ai/documentation/reference/consent/choose-a-consent-call/): in **External** mode your shop reports opt-outs with the [Unsubscribe API](https://releva.ai/documentation/reference/consent/unsubscribe-a-customer/), and the double opt-in setup is in [Set up double opt-in](https://releva.ai/documentation/reference/consent/set-up-double-opt-in/).

## Check it worked

* The **Save** button reads **Saved**.
* Reload the page: the mode, the request behaviour and the switched-on subscriptions are as you set them.
* With **Internal**, any profile page under **Data Platform › Profiles** shows a **Subscribe** or **Unsubscribe** button.

## Troubleshooting

**Subscription Request Behavaior and User Visible Subscriptions are missing.** They are shown only in **Internal** mode. In **External** mode you see **Email Unsubscribe URL** and **Subscriber Sync API** instead.

**Add subscription shows “Enter a subscription key.”** The field is empty. Type a key first.

**Add subscription shows “\<Name> already exists — select it in the list instead.”** A row with that key already exists (the check ignores case). Switch that row on instead of adding a new one.

**A key I never added appears in the list.** The list includes every subscription key your integration or API calls have ever written to a profile. Leave it switched off if customers should not see it.

**Marketing cannot be switched off.** It can be hidden only while another subscription is switched on. With nothing else on, it is shown on its own.

**Test next to Subscriber Sync API is disabled.** In the current UI the button is enabled by the catalog sync URL under **Settings › Shop & Integration**, not by the subscriber sync URL. Use **Sync Now** to run the sync.

## Next steps

* [How consent works in Releva](https://releva.ai/documentation/learn/consent/how-consent-works-in-releva/): Learn which channels the marketing opt-in gates and how double opt-in works.
* [Unsubscribe a customer from marketing messages](https://releva.ai/documentation/guides/consent/unsubscribe-a-customer/): Opt one profile out of email, SMS, Viber, WhatsApp and webhook messages, and subscribe it again if needed.
* [Check a customer’s subscription status](https://releva.ai/documentation/guides/consent/check-a-customers-subscription-status/): See whether a customer receives marketing messages, since when, and which subscriptions they hold.
* [For developers: Choose a consent call](https://releva.ai/documentation/reference/consent/choose-a-consent-call/): Hand your developer the subscribe and unsubscribe calls each mode needs.