WORDPRESS INSTALLATION · SEPTEMBER 2026

How to add Orka
to WordPress.

Your WordPress site. A conversation away.

A small snippet in your site’s head.
A direct line to the humans behind your project.

Follow the steps ↓

WordPressYour website

One inboxEvery project

<head> your Orka snippet </head>

●

YOUR WORDPRESS SITEHi! Can you help me get started?

A quick check before you start.

A self-hosted WordPress site where you can install plugins, or a WordPress.com plan that allows plugins and custom JavaScript.

WHERE YOU WILL ADD ITWP Admin → Code Snippets → Header & Footer

ONE PROJECT. ONE SNIPPET.

Bring your site aboard.

Copy the right project’s snippet

Open your Orka dashboard, then Settings → your project → Installation. Under How to embed, click Copy Code. If this is a new website, create its project first so incoming messages have the right context.

Open your site’s admin

Install and activate the Insert Headers and Footers plugin by WPCode if you do not already have a header-code tool.

Use the site-wide header

Open Code Snippets → Header & Footer. Paste your complete Orka snippet in Header, keeping the script tags.

Save and visit the site

Save Changes, clear any site cache and open your published website in a fresh browser window.

THE INSTALLATION SNIPPET

<script type="text/javascript">window.ORKA_APP_ID="YOUR_PROJECT_ID";(function(){d=document;s=d.createElement("script");s.src="//widget.orka.chat/app.js";s.async=1;d.getElementsByTagName("head")[0].appendChild(s);})();</script>

YOUR_PROJECT_ID is a placeholder. Copy the complete snippet from your own project’s Installation screen. This example contains no customer’s project ID.

The WordPress detail that matters.

Use one header-code tool, not several. You do not need to edit a theme’s header.php or add the script to every post. If a cache or script-optimization plugin delays JavaScript, check that a visitor can still open the chat when expected.

WordPress.com’s free plan does not support this installation. Its current guide lists Personal, Premium, Business and Commerce for header code. On self-hosted WordPress, plugin access depends on your hosting and account permissions.

THE FIRST HELLO IS YOUR TEST

Installed is good.
Working is better.

Use a real published page and a test visitor. You are checking the complete journey, from the widget to the right project in your inbox.

Open it like a customer.Visit the published site on desktop and mobile. Open the widget and check that it does not cover a key control.
Send a recognizable test message.Use something like “Installation test — WordPress”. Check it arrives in the project you intended.
Answer from the shared inbox.Reply once and confirm the answer reaches the visitor. Then visit another site page and check again.
Set the welcome before inviting people in.Review your colors, availability, reply expectations and help articles. Choose AI behavior separately.

One more project? Same open tab.

Repeat with the next project’s snippet. SaaS, app, shop or publication: the conversations can all come to one inbox.

Explore the portfolio workflow ↗

YOUR BEARINGS, BEFORE YOU DIVE IN

Your WordPress
installation questions.

Still wondering about something?
Ask a human at Orka ↗

Where do I find my Orka snippet?

Log in to the Orka dashboard, open Settings, select the project for this website and choose Installation. Click Copy Code in How to embed. Use that project’s full snippet, not the placeholder shown in this guide.

What do I need on WordPress?

A self-hosted WordPress site where you can install plugins, or a WordPress.com plan that allows plugins and custom JavaScript. WordPress.com’s free plan does not support this installation. Its current guide lists Personal, Premium, Business and Commerce for header code. On self-hosted WordPress, plugin access depends on your hosting and account permissions.

Do I add it to every page?

Use the site-wide header or the shared layout so the script is included wherever you want chat. Add it once, not through both a plugin and a theme. Test the homepage and an inner page.

Does every website need a different project ID?

Use a separate Orka project for each distinct product or store whose context you want to keep separate. Copy its own snippet. The conversations can still appear together in your shared inbox.

Why is the widget missing?

Check the published site, confirm the project ID and complete script are present, and look for duplicate installations. Review your platform’s plan restrictions, cache, consent settings and browser extensions. If it still fails, send Orka the public page URL and the error you see.

Does installing the snippet enable AI automatically?

Installing the widget is separate from choosing your knowledge and AI behavior. Configure the project, review its answers and decide whether you want human replies, AI drafts or automatic replies. AI usage is separate from the team plan.

THE DOCUMENTATION BEHIND THE GUIDE

Checked, with a way to check again.

Valid as of September 2026. Official sources checked 21 September 2026. Platform menus, plans and prices can change. If we have something wrong, email [email protected].

How to add Orkato WordPress.