Setup & site building · Guide
How to Add WhatsApp to Your WordPress Website (Step by Step)

Short answer
Create a click-to-chat link using wa.me followed by your full international number, then add it to a Buttons block. For a button on every page, install a free plugin such as Joinchat or Click to Chat, enter your number and choose a position.
Key takeaways
- A wa.me link opens a WhatsApp chat with your number, no plugin needed.
- Write the number with the country code and no plus sign, spaces or dashes.
- Free plugins like Joinchat and Click to Chat add a floating button.
- Add a QR code on your contact page for desktop visitors.
- Mention WhatsApp in your privacy policy.
- Test the button on mobile and desktop after setup.
How do I add WhatsApp to my WordPress website?
Add WhatsApp by linking a button to a wa.me click-to-chat URL with your phone number, or by installing a free plugin such as Joinchat or Click to Chat that adds a floating WhatsApp button to every page.
Both options open a chat with you in the WhatsApp app or WhatsApp Web when a visitor clicks. You do not need the WhatsApp Business API for this. A normal or Business WhatsApp number works.
Pick the method that fits your site:
| Method | Cost | Best for | Effort |
|---|---|---|---|
| wa.me link in a Button block | Free | One or two contact buttons on key pages | 5 minutes |
| Floating chat plugin | Free, with paid upgrades | A button on every page | 10 to 15 minutes |
| QR code image | Free | Print, desktop visitors, contact pages | 5 minutes |
| WooCommerce WhatsApp plugin | Free or paid | Product questions and orders | 20 minutes or more |
| Custom code in a theme | Free | Developers who want full control | 30 minutes or more |
The steps below cover each one, starting with the simplest.
What is a wa.me click-to-chat link?
A wa.me link is WhatsApp's official short URL that opens a chat with a specific phone number, written as https://wa.me/ followed by your full international number with no plus sign, spaces or dashes.
WhatsApp documents the format on its click to chat help page. For example, the number +44 7700 900123 becomes:
https://wa.me/447700900123
You can also pre-fill a message. Add ?text= and a URL-encoded message:
https://wa.me/447700900123?text=Hi%2C%20I%20have%20a%20question
Rules to get right:
- Use the country code first, without
00or+. - Remove the leading zero from local numbers.
- Do not include brackets, spaces or dashes.
- Encode spaces as
%20in the pre-filled text.
Test the link on your phone before adding it to the site. If WhatsApp says the number is invalid, the format is wrong.
How do I add a WhatsApp button without a plugin?
Insert a Buttons block in the editor, type your button text, then paste your wa.me link as the button's URL and set it to open in a new tab.
Step by step:
- Open the page or post where you want the button.
- Click the + inserter and add a Buttons block.
- Type the label, such as Chat on WhatsApp.
- Click the link icon in the block toolbar and paste your wa.me URL.
- Turn on Open in new tab in the link options.
- Style the button in the sidebar. WhatsApp's familiar green works well, but match your brand if you prefer.
- Save and test on desktop and mobile.
For layout help, see how to center a button in WordPress.
To match your brand colors, follow how to change button color in WordPress.
To put the button on every page, add it to your footer or header template. In a block theme, open Appearance > Editor > Patterns or Templates, edit the footer template part, and add the same Buttons block.
You can also link plain text the same way. Our guide on how to add a hyperlink in WordPress shows the steps.
How do I add a floating WhatsApp button with a plugin?
Install a WhatsApp chat plugin from the plugin directory, enter your phone number in its settings, choose the button position and style, and save to show a floating icon across your site.
Two popular free options on WordPress.org:
- Joinchat, which adds a floating button with an optional chat-style welcome message.
- Click to Chat by HoliThemes, which offers several button styles and shortcodes.
General setup steps (menu names differ slightly by plugin):
- Go to Plugins > Add New Plugin and search for the plugin name.
- Click Install Now, then Activate.
- Open the plugin's settings page, usually in the main admin menu or under Settings.
- Enter your phone number with the country code.
- Add an optional pre-filled message or call to action.
- Choose the position, such as bottom right, and the button style.
- Set where it shows, such as all pages, or hide it on checkout or certain posts.
- Save and check the front end on mobile.
Check each plugin's Last updated date and active installs before choosing. Read the plugin page for the current free and paid features, as these change over time.
How do I add multiple agents or numbers?
Use a plugin that supports multiple accounts, or add several buttons each pointing to a different wa.me link, so visitors can pick sales, support or a specific person.
Several chat plugins offer multi-agent features, often in a paid version. They show a small list of team members with names, photos and availability.
A free alternative is a simple contact section:
- A Columns block with one column per department.
- In each column, a heading, a short line of text and a Buttons block.
- Each button linked to that team's wa.me URL.
This works well on a contact page. Keep the floating button pointed at your main number so it stays simple.
How do I add a WhatsApp QR code?
Generate a QR code for your wa.me link, upload it as an image, and place it on your contact page so desktop visitors can scan it with their phone.
WhatsApp Business also generates a QR code for your number inside the app. Look in the business tools section of WhatsApp Business.
Alternatively, create one from your wa.me link with any QR tool. Read can WordPress generate a QR code for plugin options.
Add the image with an Image block. Write alt text such as QR code to chat with us on WhatsApp for screen reader users. Add the clickable link next to it for mobile visitors, who cannot scan their own screen.
How do I use WhatsApp for WooCommerce orders?
Add a Ask on WhatsApp button to product pages with a WooCommerce-aware chat plugin, which can pre-fill the product name and link so customers ask about a specific item.
Some chat plugins include WooCommerce options, such as showing the button on product pages only or inserting the product title into the message. Others are built for ordering through WhatsApp instead of the checkout.
Be careful replacing checkout with WhatsApp. You lose automatic stock updates, tax handling and order records. Most stores keep the normal checkout and use WhatsApp for pre-sale questions.
For broader messaging, WhatsApp Business offers catalogue and messaging features. Automated messaging through the API usually needs an approved provider.
Does adding WhatsApp affect privacy or speed?
A plain wa.me link loads nothing extra and sends no data until clicked, while chat plugins add some scripts and styles, so pick a lightweight one and review your privacy policy.
On speed:
- A Buttons block with a link adds no extra requests.
- Most chat plugins load a small script and stylesheet on each page. Test with your usual speed tool after installing.
On privacy, clicking the button sends the visitor to WhatsApp, which is owned by Meta. Mention this in your privacy policy.
This is general information, not legal advice. If you serve visitors in the EU or UK, see GDPR compliance for WordPress.
Some plugins offer an option to load the button only after cookie consent. That pairs with a cookie consent banner.
Why is my WhatsApp button not working?
A WhatsApp button usually fails because the phone number format is wrong, a cache is serving old pages, or a plugin conflict or security setting blocks the button's script.
Quick fixes:
- Invalid number message. Remove
+, spaces and the leading zero. Use the full country code. - Button not showing. Clear your cache plugin and any CDN, then reload in a private window.
- Opens a blank page on desktop. Visitors need WhatsApp Desktop or WhatsApp Web signed in.
- Button hidden behind other elements. Change the position or z-index option in the plugin, especially if a cookie bar or back-to-top button overlaps.
- Plugin conflict. Temporarily switch to a default theme and disable other plugins to find the culprit.
For links opening in a new tab, the browser handles target="_blank" as described on MDN's anchor element page. WordPress adds safe rel attributes automatically.
Which WhatsApp method should I choose?
Choose a wa.me Button block for a simple, fast contact option on a few pages, and choose a floating chat plugin if you want WhatsApp visible everywhere with scheduling or multiple agents.
A quick rule of thumb:
- Service business or freelancer: a Button block on the contact page and footer is enough.
- Shop with frequent questions: a floating plugin with WooCommerce support.
- Team with several departments: a multi-agent plugin or a contact grid.
If you also want automated answers outside working hours, compare WhatsApp with adding an AI chatbot to WordPress. Many sites use both.
Frequently asked questions
Do I need WhatsApp Business to add WhatsApp to WordPress?
No. A click-to-chat link works with a normal WhatsApp number too. WhatsApp Business adds useful extras such as a business profile, away messages, quick replies and a catalogue, so it is worth using if the number is for customers.
How do I write my number in a wa.me link?
Use your full international number with the country code first. Leave out the plus sign, any leading zero, spaces, brackets and dashes. For example, a UK mobile becomes 44 followed by the rest of the number without the first zero.
Can I add a WhatsApp button without a plugin?
Yes. Add a Buttons block, paste your wa.me link as the button URL and set it to open in a new tab. Place the same block in your footer template if you want it on every page of the site.
Will a WhatsApp plugin slow down my site?
Most chat plugins add a small script and stylesheet, which usually has a minor effect. A plain link in a Buttons block adds nothing. Test your pages with a speed tool after installing and pick a lightweight, well-maintained plugin.
Why does my WhatsApp button say the number is invalid?
The number format is almost always the cause. Remove the plus sign, spaces, dashes and any leading zero, and make sure the country code comes first. Test the link on your phone before adding it to the site again.
Sources
- How to use click to chat WhatsApp Help Center
- Joinchat WordPress.org Plugins
- Click to Chat WordPress.org Plugins
- WhatsApp Business WhatsApp
- The Anchor element MDN Web Docs
Is your product missing, or something out of date?
Tell us what to add or correct. We read every note and reply when we need a source. A message does not buy a ranking.
Thanks — we review requests within 3 business days.
Related guides
About the editors
Researched from the primary sources listed above and checked against our editorial rules before publishing.


