To add an unsubscribe link in Smartlead, open the campaign's settings and enable “Add unsubscribe message in all emails,” or place the documented %unsubscribe-text% placeholder where the opt-out text should appear. Save the campaign, inspect a message actually delivered to a controlled recipient, and confirm the opt-out changes the lead's status. A test email preview is not enough: Smartlead says its test emails intentionally omit the working unsubscribe link. Smartlead's unsubscribe instructions document both insertion methods and that testing limitation.
The link is only one part of a safe workflow. A recipient can also reply with an opt-out request, and an agency may run campaigns under several client accounts. This guide covers how to configure the link, how to handle those other requests, and how to check that import settings do not put someone back into outreach. We checked Smartlead and Google documentation on October 1, 2026; we did not test a private Smartlead account or make a claim of legal compliance for a particular campaign. For the wider platform decision, see our Smartlead review.
Before changing a campaign, identify the sending mode
Smartlead's new campaign guide places Add unsubscribe message to all emails under Protection & Limits. Other current Smartlead help pages describe reaching it via Edit Campaign → Campaign Settings → Unsubscribe. Use the label present in your account, then verify the resulting sent email rather than assuming two help-center screenshots describe exactly the same UI.
Check whether the campaign uses Optimize Email Delivery or plain-text delivery. Smartlead says this mode removes HTML content, including its unsubscribe link, and cannot be changed after a campaign starts. If a live campaign is in that mode, do not tell the team it has a functioning click-to-unsubscribe merely because the footer text was entered in Settings. Ask Smartlead support how to correct the live campaign or plan a properly configured replacement, and keep manual opt-out handling active in the meantime.
| Choice | Practical result to verify |
|---|---|
| Add unsubscribe message in all emails | The configured text/link appears in every actual campaign email where Smartlead supports it. |
%unsubscribe-text% in sequence copy |
The opt-out text appears at the chosen position in that sequence step. Check every variant and follow-up. |
| One-click unsubscribe header tag | The actual message has the intended List-Unsubscribe headers; a visible body link alone is a different mechanism. |
| Plain-text/optimized delivery mode | Smartlead says its built-in HTML unsubscribe link is removed. A reply-based request still needs a human suppression route. |
Smartlead's detailed unsubscribe page says enabling its all-email message can add an Unsubscribe Header Tag and shows an optional control for that tag. Its campaign creation guide also calls out a separate header option. Check the actual setting and delivered headers in your account. Google's sender guidelines distinguish a body link from the List-Unsubscribe and List-Unsubscribe-Post headers used for one-click unsubscribe; which requirements apply depends on the message and sending pattern. Do not assume turning on a footer alone settles all provider or legal requirements.
Configure the visible opt-out
- Open the specific Smartlead email campaign and use Edit Campaign or its Settings tab. Find Add unsubscribe message in all emails in the unsubscribe or Protection & Limits area.
- Enable it and enter short, clear text so a recipient understands the action. Use Smartlead's generated opt-out mechanism rather than a generic link to a page that does not identify the lead. Save the campaign settings. Smartlead documents this all-email route.
- If placement inside the message is important, use the documented
%unsubscribe-text%placeholder in each applicable sequence step instead. Inspect both options in your account to avoid a duplicate footer. Smartlead's shorter guide describes the placeholder as the alternative to a default footer. - Inspect the separate Unsubscribe Header Tag or one-click setting if it is displayed. Record the setting chosen, and check the headers of a delivered message when one-click support matters for your traffic.
For a campaign with several variants or follow-ups, a preview of only the first email does not prove every step has the opt-out. Use a checklist with each active variant and sequence step. The new campaign workflow has a review stage, but Smartlead says test emails omit the live unsubscribe link; only a controlled actual send can confirm the rendered result and link behavior.
Test without risking a prospect's address
Use a mailbox your organization controls as the recipient of a small, legitimate test campaign. Send an actual campaign email through the intended sender and inspect the received body and message headers. Click the opt-out link from that controlled mailbox, then verify Smartlead marks that lead as unsubscribed and stops its future campaign messages. Check any related CRM or suppression process separately. Do not click the link in a real prospect's email simply to test it; that would change the prospect's state.
Smartlead's help article says link clicks mark the lead unsubscribed so future imports skip them. Its longer guide calls this global unsubscribe and separately describes a campaign-only manual unsubscribe. Both pages agree that a clicked link should not be treated as merely a reply tag. If the specific scope is important, verify the lead's status in your account and run a controlled future-import check; do not infer cross-client or cross-tool suppression from the word “global.”
Handle a reply that asks to stop
A person who replies “stop,” “remove me,” or an equivalent request may never click the link. Route that request to the owner who handles opt-outs, stop the relevant follow-up, and put the address on the proper suppression list. Smartlead's short unsubscribe guide suggests adding a “not interested” reply to the Global Block List. For an explicit opt-out, err on the side of suppression rather than treating it as a future nurture opportunity.
In a May 2023 CRM walkthrough, Jan described recording unsubscribe requests in a separate list so his team would not reach out again. That is a historical account of his process, not a claim that today's Smartlead automatically syncs with every CRM. If you use a CRM, ensure its opt-out state reaches the sending system; our Smartlead + Make guide explains the separate event-handoff design, though that article's interested-reply route should never receive opt-outs.
For a client-managed agency, the Global Block List has a client boundary. Smartlead says an unassigned block entry applies to campaigns with no client, while a client-assigned campaign needs a block entry assigned to that same client. To block an address across several client contexts, it says to add a separate entry for each relevant client. Read its current block-list guide and blocked-lead troubleshooting before assuming one “global” entry covers an agency's entire portfolio. Never share an opted-out address between unrelated clients without an authorized reason and data-handling basis; define each client's suppression responsibility.
Prevent the next list import from undoing the opt-out
Smartlead's new campaign import workflow lists Global Block List and Unsubscribe List as separate preferences that exclude previously blocked or unsubscribed leads. Its longer unsubscribe guide also says an operator can choose to include previously unsubscribed leads during a new upload. That is why a one-time successful click test does not finish the operating design.
Before importing each list, confirm that both exclusion preferences are active for the client and campaign, and that nobody selected an override to re-add opted-out leads. Reconcile suppression in any other sender or CRM used by the team. A local campaign-only unsubscribe is not the same as a durable do-not-contact rule for later campaigns. If a lead is still mailed after a block, Smartlead says to check timing, the client association of both block entry and campaign, and the exact email/domain format. Its troubleshooting article explains those cases.
Troubleshooting checklist
| Symptom | Next check |
|---|---|
| No link in a Smartlead test email | This is documented test-email behavior. Inspect a controlled actual campaign send before concluding the live footer is missing. |
| No link in a delivered campaign email | Check the all-email message or %unsubscribe-text% in that sequence step, then check plain-text/Optimize Email Delivery settings. |
| Footer exists, no Gmail one-click control appears | Inspect the one-click/header setting and the actual List-Unsubscribe headers. The body link and mailbox UI are not interchangeable evidence. |
| Recipient replied “stop” but remains in a sequence | Stop the immediate follow-up, record the request and add the correct suppression entry for that client. Do not wait for a click event that will not arrive. |
| Unsubscribed lead appears in a new import | Check Unsubscribe List and Global Block List exclusions, any import override, and whether the new campaign belongs to a different client context. |
| Blocked lead still gets mail | Compare campaign and block-entry client IDs, when the block was added, and the exact address/domain format. Escalate persistent mismatch to Smartlead support with minimal necessary evidence. |
The goal is a closed opt-out path: visible way to leave, reply handling, durable suppression, and a check during the next import. If your agency gives clients access to their own campaigns and inboxes, the client-access setup guide explains how to keep those assets scoped. Review the applicable email-provider rules and laws for your actual message type and recipients rather than treating a product toggle as a compliance certificate.
Disclosure: OutboundXYZ has a Smartlead affiliate relationship. This guide uses current public Smartlead and Google documentation plus a dated historical Jan video; it reports no private test or guaranteed sending outcome.
