Newsletter

Subscribe shoppers to the store newsletter with consent and confirmation settings enforced.

POST /newsletter/subscribe

{% form 'newsletter_subscribe' %}

Subscribes the email to the store newsletter. Double opt-in applies when the store requires confirmation, and the confirmation link lands on /newsletter/confirm. An already-active subscription returns success unchanged; a pending request receives a fresh confirmation. The honeypot suppresses simple bots.

Form fields

email Required: Subscriber email.
website Optional: Honeypot — must stay empty; bots that fill it are dropped.
_format Optional: Set to json when submitting with fetch; omit for the normal browser redirect.

Validation

Valid non-empty email; CSRF and honeypot enforced. An active subscription returns success unchanged. A pending double-opt-in subscription receives a new confirmation token and email. Hosted submissions are recorded with source=website.

Limits

Subscribing an address that is already subscribed changes nothing. Under heavy traffic the store may ask the browser to complete a short challenge first.

Response

{
  success:true,
  response,
  requires_confirmation
}