Disconnect and remove Needlr

Take Needlr out of your Tag Manager cleanly: what it removes, what happens to running impact checks and shipped changes, and the code it asks for.

You can take Needlr off your website at any time. One button removes everything Needlr added to your Google Tag Manager, publishes that, and takes away Needlr's access.

Think of a guest packing up

Needlr is a guest in your Tag Manager. When it leaves, it packs only its own bags, leaves everything of yours where it was, and hands back the key.

Before you disconnect

• Running impact checks stop getting data. Without Needlr on your site, nobody is split or counted. Open each running one and press Stop first (how). If you leave one running, its KPI soon shows Stopped firing, and the impact check is put on hold (more).
• Shipped changes go away. A winner you shipped through Needlr is shown on your site by Needlr. Once Needlr is removed, your site shows the old version again. Move it into your site's code first (how).
• Before vs after checks counted by Google Analytics keep working. They read your Google Analytics, not your Tag Manager (more).

How to disconnect

1. 1Open your project and go to the Settings tab.
2. 2On the Google Tag Manager card, press Disconnect. It's at the bottom of the card. Only Owners and Editors see it (roles).
3. 3A window asks Remove Needlr from Google Tag Manager? Type the 6-digit code from your authenticator app. One code covers 20 minutes, so you may only need to confirm (more).
4. 4Lost your phone? Press Lost your phone? Use a recovery code and type one of the codes you saved (more).
5. 5Press Remove and disconnect. When it's done, the card shows Connect Google Tag Manager again.

What Needlr removes

• Its snippet, its tags, the triggers that count your KPIs, and its templates.
• It works in its own workspace and publishes a clean version of your container.
• Only then does it give up its Google access. If another of your projects uses the same Google account, that project keeps working.
• Your own tags, triggers and variables are not touched.

If it can't finish

Needlr never removes half of its tags. If something blocks it, nothing is removed, the connection stays, and the card says why.

• Someone has an unpublished version in Google Tag Manager. Publish it or delete it in Tag Manager, then press Disconnect again.
• Your GTM container has no free workspace. Free Tag Manager accounts allow 3. Delete one you don't use, then try again.
• The card says Reconnect needed. Then there's no Disconnect button. Press Reconnect Google first, then disconnect.

Two things to do by hand

• The no-flicker line. If you pasted it into your site, delete it from your site's code too. Needlr can't reach it. Without Needlr, it can hide your page for up to a second (more).
• Needlr installed in your code. If a developer added Needlr with the Project key instead of Tag Manager, they need to take it out of the code.

Other connections

• Google Analytics: press Disconnect on its card. No code needed. Checks measured with it keep their last numbers but stop updating (more).
• Slack: press Disconnect on the Slack card under Alerts for the whole account. Emails keep coming (more).

What stays

Your verdicts, your timeline and your KPIs stay in Needlr. To come back, press Connect Google Tag Manager and pick your container again (how).

Want everything gone, data included? Delete the project instead. It also removes Needlr from your Tag Manager first (more).

Common mistakes

• Deleting Needlr's tags by hand in Tag Manager. Every impact check stops, and Needlr still thinks it's connected. Use Disconnect instead.
• Disconnecting with a winner still shipped through Needlr. Your site quietly goes back to the old version. Move it into your code first.
• Forgetting the no-flicker line. It stays on your site until you delete it.