ToolsFeaturesPricingAPIGuidesBlogAboutFAQContact

Pinterest Tag Code Builder & Checker

Type your tag ID and tick the events you track. You get the base code and each event’s code in Pinterest’s own documented shape, with where each one goes. Or paste the tag you already have to check it.

Your Pinterest tag

Add your tag ID to fill in the code

The code below has Pinterest’s placeholder, YOUR_TAG_ID, until you type yours.

Ads Manager › Conversions shows it. It is in your site’s source for anyone to see, so it is not a secret.

The events you track
11 more of Pinterest’s events
Also

· What you paste stays on your device and never goes into the link.

Every rule and event name is from Pinterest’s Track conversions with Pinterest Tag and Use Pinterest Tag Helper. Checked 3 October 2026.

    Quick answer: Pinterest says The Pinterest Tag has two components: the base code, on every page of your site, and an event code on each page where something you want to count happens, such as a checkout. The base code goes between <head> and </head>, and Pinterest says It must appear only once on a page and must run before the subsequent event code. Type your tag ID above and tick your events: the code comes out filled in, with where each part goes.

    How to use it

    1. Copy your tag ID from Ads Manager › Conversions. It is a number. It sits in every page of your site's source, so it is not a secret.
    2. Tick the events you track. A shop usually wants page visit, add to cart and checkout. Pinterest lists those three as required for catalog sales campaigns.
    3. Paste each block where it says. The base code goes on every page. A checkout goes on the order confirmation page. An add to cart runs when the button is clicked, not as the page loads.
    4. Check it. Paste the tag you already have into the box under the builder. Pinterest's own Tag Helper extension for Chrome then shows which events fire on a real page.

    Where each event goes

    Some events can run as the page loads. Pinterest's example: when your website loads a checkout confirmation page, you are certain that a checkout has occurred. Others must wait for the reader to do something: some events are triggered only after a user takes a specific action on a page, such as clicking a button or submitting a form. In this case, you need to be sure that the event code runs only as a result of the action. An add to cart that fires on page load counts everyone who looked at the product.

    Only two pieces of event data reach Pinterest's reports: We only offer reporting on the value and order_quantity event data at this time. Pinterest's table says the value (must be a number) and the quantity (must be an integer). For currency it lists six codes: One of the following: USD GBP CAD EUR AUD or NZD.

    The mistakes the checker looks for

    • Curly quotes. ‘like this’ is not a quote to JavaScript, and the script stops at that line. Word processors, chat apps and some web pages make them. Pinterest's own copy-and-paste checkout example has one, in event_id: ‘eventId0001’, which is probably why it also says It is not recommended to copy and paste the tag code from this guide.
    • The base code twice. A theme, a plugin and a tag manager can each add it. Pinterest wants it once per page.
    • A base code without its !. The code must start !function(e){. Without the ! the browser reads a broken function and the tag never loads. The first base-code example on Pinterest's developer page is missing it.
    • An event before the base code. Pinterest: The base code must run before the event code.
    • An event name Pinterest doesn't know, such as purchase for checkout. Pinterest counts it as a custom event, which you then have to map: Make sure to map any custom event to a Pinterest standard event.
    • A value with a currency sign or quotes, a currency outside Pinterest's six, or a line break in the image tag's address. Pinterest: Adding whitespace in the src attribute will break the code.

    Enhanced match, without a real email

    Enhanced match adds the shopper's email to the base code so Pinterest can count more conversions. The builder writes a placeholder for your site's own variable, never an address. In the script Pinterest hashes it for you: To protect user privacy, the <email_address> passed to the pintrk command will be hashed before it is sent to Pinterest. The image tag is different: Partners that use the img tag will need to format and hash the email address and external ID themselves.

    Tag managers and the Tag Helper

    Pinterest's FAQ: Yes, the Pinterest Conversion Tag can be added as a custom tag in every tag manager. In Google Tag Manager that means a Custom HTML tag for the base code on all pages, and one for each event on its own trigger. After it goes live, Your tag should be verified within 3 hours of its first use. To see it working on a page, Pinterest points to its Tag Helper extension for Chrome: Tag Helper is a Google Chrome extension that can help check whether your tag has been set up properly. Selling on Pinterest? The tag is one of the four things Pinterest asks for before a catalog. The Ready to Sell on Pinterest? checklist shows the other three.

    FAQ

    Where do I find my Pinterest tag ID?
    In Ads Manager, under Conversions. Pinterest generates the base code there with your ID in it, and says "Get your personalized base code from our UI or API." The builder writes the same code around the ID you type.
    Do I need the base code on every page?
    Pinterest recommends every page, so you can build audiences from your whole site. At a minimum it must be on every page with an event code, and it must run first.
    Should I use more than one Pinterest tag?
    No. Pinterest: "No, you only need one Pinterest Conversion Tag, which will be your base code that you place across your entire site."
    Why are my Pinterest conversions not showing?
    Paste your tag into the checker above. Curly quotes, a base code that loads twice or runs after the events, and an event name Pinterest doesn't know are the common causes. Then open the page with Pinterest's Tag Helper to see which events fire.
    Is the Pinterest tag the same as the Conversions API?
    No. The tag runs in the visitor's browser; the Conversions API sends events from your server. This page writes the tag.