Pinterest Widget Builder
Save buttons, Follow buttons and Pin, Board & Profile embeds — with a live preview.
A visitor who saves your image to Pinterest is doing your marketing for you: the pin sits on their board, links back to your page, and keeps sending traffic for months. Yet most sites make saving harder than it needs to be. The share bar is buried at the bottom, the pin image is a wide blog header that looks wrong on Pinterest, or the embed code was copied from an old forum post and quietly stopped working. Pinterest's own widget builder is dated and fiddly, and generic social plugins load heavy scripts for every network at once. This Pinterest widget builder generates exactly the code you need for five widgets: a Save button for one specific image or for any image on the page, a Follow button for your profile, and embeds that show a single pin, a whole board or your profile. A live preview renders the real widget before you copy anything. Below the tool we explain how the code works, where to put it in WordPress, the common reasons widgets fail to appear, and the privacy trade-off that comes with adding any Pinterest script to your site.
What this tool does
Pinterest widget code with a live preview
Every Pinterest widget is made of two pieces. The first is an ordinary link tag carrying a data-pin-do attribute that tells Pinterest which widget to draw, such as buttonPin, buttonBookmark, buttonFollow, embedPin, embedBoard or embedUser. The second is Pinterest's script, pinit.js, which scans the page for those tags and replaces each with the real widget.
The builder fills in the right attributes from simple form fields. Paste a pin, board or profile URL and it extracts the ID or path for you. Choose button shape, size, colour and language, or widget width and thumbnail dimensions for embeds. Inputs are validated as you type, so you find out about a malformed URL before you paste the code into your site, not after a reader reports a blank space.
The preview loads Pinterest's official script inside a sandboxed frame, so it renders exactly as it will on your site. The only network requests go from your browser to Pinterest to draw that preview. Nothing you type is sent to Cybertrickz.
Use cases
Which Pinterest widget fits which job
Save button under a pin-ready image
Food, craft and travel bloggers often design a tall 2:3 image for each post specifically for Pinterest. A Save button tied to that image ensures every save uses the right picture and your chosen description, instead of whatever image a visitor happens to pick.
A general share button in the post footer
The “let the visitor pick” mode opens Pinterest's image picker, showing every suitable image on the page. It works well as one Pinterest option in a share bar when posts contain several good images and you would rather not choose for the reader.
Follow button on About and contact pages
A Follow button turns interested readers into Pinterest followers without sending them off to search for you. It is most effective on pages where people already want more from you, such as your About page, author box or newsletter confirmation page.
Embedding a single pin in an article
Referencing a specific idea, product or infographic? Embedding the pin shows it with Pinterest's own framing and a Save button, gives credit to the original pinner, and avoids rehosting someone else's image on your server.
Board embeds as living galleries
A board embed shows a scrolling grid of the latest pins on a board. Shops use it for lookbooks, planners for inspiration pages, and creators to showcase a curated collection that updates automatically whenever they pin something new.
Profile embed on a landing page
A profile widget displays your most recent pins across all boards. It is a quick way to show a new Pinterest presence on a link-in-bio page or portfolio and gives visitors a reason to follow without leaving your site.
Install it right
Where the code goes, and why widgets fail
Anchor where it appears, script once per page
Paste the anchor tag exactly where the widget should show. Add the pinit.js script tag once per page, ideally just before the closing body tag. Loading the script twice on the same page causes unpredictable results, so if you use several widgets, keep a single script tag. In WordPress, paste widget code into a Custom HTML block rather than a paragraph, because the rich text editor strips data- attributes. For sitewide placement, add the script once through your theme's hooks; in GeneratePress that is an Elements hook.
Common reasons a widget will not appear
- The script is missing, blocked by a caching or optimisation plugin, or loaded twice.
- The board or profile is secret or private. Pinterest only renders public content.
- The editor removed the
data-pin-doattribute. - The pin was deleted, or the username or board URL changed.
- A visitor's ad or tracker blocker is hiding Pinterest's script, which is outside your control.
The privacy trade-off
Pinterest's script is third-party code: once it loads, Pinterest can see that someone visited the page. If you publish to readers in the UK or EU, mention it in your cookie notice and consider loading the script only after consent. That is also an argument for a single well-placed Save button over a hover button on every image. Full attribute reference is in Pinterest's developer documentation. Before adding a Save button, make sure the image is worth saving with our Pinterest image resizer, and pair your pages with valid structured data from the schema markup generator.
Step by step
How to add a Pinterest widget to your website
Five steps from blank form to a working widget on your site. Step four is where most embeds break, so it gets the most detail.
Choose the widget type
Pick Save button, Follow button, Embed a Pin, Embed a Board or Embed a Profile from the tabs. Base the choice on the action you want from the visitor. If you want people to save a specific image, use the Save button. If you want followers, use Follow. If you want to display content from Pinterest on your page, use one of the embeds. Each tab shows only the fields that widget needs.
Fill in the fields and let the tool validate them
For a Save button tied to one image, enter the page URL, the full image URL and a keyword-rich description. For Follow or Profile, enter your username or paste your profile URL and the tool extracts the handle. For a Pin, paste the pin's address and it finds the numeric ID. For a Board, paste the board URL. Fields turn red with a short message when something cannot be parsed.
Adjust appearance and check the live preview
Set the button shape, size, colour and language, or the widget width and thumbnail sizes for embeds, respecting the minimums shown. Watch the live preview update as you change settings. It uses Pinterest's real script in a sandboxed frame, so if the preview stays empty, the pin, board or profile is probably private, deleted or mistyped. Fix that before going further.
Copy the code and paste it into your site correctly
Press Copy and paste the code where the widget should appear. In WordPress, use a Custom HTML block, never a paragraph block, so the data attributes survive. If you already have pinit.js on the page from another widget or plugin, delete the duplicate script tag from the pasted code and keep only the anchor. On other platforms, use an HTML or embed element rather than a rich text box.
Publish, test, and update your cookie notice
Publish the page and view it while logged out, on desktop and on a phone, to confirm the widget renders and clicks through to Pinterest correctly. Clear any page cache if you do not see it. Test once with an ad blocker on, so you know how the page looks for those readers. Finally, add Pinterest to your cookie or privacy notice as a third-party service your pages load.
Why a Save button is worth the code
Sources: Pinterest Q3 2026 results (SEC filing); Pinterest product specs; Pinterest developer docs.
The preview loads Pinterest's official pinit.js in a sandboxed frame, so it renders exactly as it will on your site. Nothing you type is sent to us.
Fill in the fields above.
FAQ
Frequently asked questions
How do I add a Pinterest Save button to my website?
Choose the Save button tab, decide whether it saves one specific image or lets the visitor pick, fill in the fields and copy the code. Paste the anchor tag where the button should appear and include Pinterest's pinit.js script once on the page. In WordPress, use a Custom HTML block. Publish, then test the button while logged out to confirm it opens Pinterest with the right image.
What is the difference between the two Save button modes?
One specific image uses data-pin-do="buttonPin" and always saves the image URL and description you set, which is ideal under a pin-optimised graphic. Let the visitor pick uses data-pin-do="buttonBookmark", which opens Pinterest's picker showing every suitable image on the page. That works as a general share option in a post footer when you have several good images and no single preferred one.
Why is my Pinterest widget not showing?
The most common causes are a missing or duplicated pinit.js script, an editor that stripped the data-pin-do attribute, or a board or profile that is secret. Caching and script-optimisation plugins can also delay or block the script; exclude pinit.js from deferral or combination. Deleted pins and changed usernames break embeds too. Finally, ad and tracker blockers hide Pinterest widgets for some visitors.
Do I need a Pinterest business account to use widgets?
No. Save buttons work for any page, and Follow, Pin, Board and Profile embeds work with any public Pinterest account. A free business account is still worth having if you use Pinterest for traffic, because it unlocks analytics, Rich Pins and website claiming, which shows your site's name and profile picture on pins saved from your domain and builds trust.
Will adding a Pinterest widget slow down my site?
Slightly. pinit.js is a small script, but it is third-party code that adds network requests and some main-thread work. Load it once per page, place it near the closing body tag, and add widgets only where saving or following is likely. Avoid hover Save buttons on every image if performance is tight, since they make Pinterest's script inspect every image on the page.
Is the Pinterest widget GDPR-compliant?
That depends on how you load it. Pinterest's script can receive information about visits to pages that include it, so in the UK and EU it is generally treated as a third-party service that needs disclosure and often prior consent. List Pinterest in your cookie notice, and where your consent tool supports it, load pinit.js only after the visitor accepts the relevant category.
Can I embed a secret or private board?
No. Pinterest only renders public pins, boards and profiles in widgets. If a board is secret, the embed shows nothing, which is a deliberate privacy protection rather than a fault. Make the board public first, or create a separate public board with the pins you want to showcase. The live preview in the builder confirms immediately whether Pinterest will render a board.
How do I add the Pinterest script only once in WordPress?
Add pinit.js once sitewide through your theme. In GeneratePress, create a Hook Element on the wp_footer hook containing the script tag, and set it to display on the posts where you use widgets. Then paste only the anchor tags into Custom HTML blocks in your posts. If a social sharing plugin already loads pinit.js, rely on that and do not add another copy.
Can I style the Pinterest Save button to match my brand?
You can choose from Pinterest's built-in options: rectangular or round shape, small or large size, and red, grey or white colour, plus a saved-count label on rectangular buttons. Pinterest renders the button itself, so heavy custom styling is not supported. If you need a fully custom design, a plain link to Pinterest's pin creation URL with your own styling works, without the live save count.
A hover Save button on every image is a privacy cost most bloggers never priced in.
pinit.js is a third-party script that lets Pinterest see your page visits. Use one targeted Save button where saving is likely, and disclose it in your cookie notice.
Share on XNew free tools, once a month
One short email when a new tool ships or an old one gets a real upgrade. No tracking pixels, no daily digests.
Join the conversation: Show members where you placed your Save button and whether saves went up. Placement tips are the most requested topic. Join the free Cybertrickz community, where members hear about new tools first.