Requirements
Before you begin, make sure you have:
- WordPress 6.0 or higher
- PHP 7.4 or higher (PHP 8.0+ recommended)
- Administrator access to your WordPress site
- An n8n instance with a webhook URL (optional for initial setup)
Method 1: Install from WordPress Plugin Directory
The easiest way to install N8.Chat is directly from the WordPress Plugin Directory. This ensures you always get the latest verified version.
Navigate to Plugins
From your WordPress admin dashboard, go to Plugins → Add New
Screenshot placeholder: WordPress Plugins menu
Search for N8.Chat
In the search box, type "N8.Chat" and press Enter. Look for the official N8.Chat plugin with the orange icon.
Screenshot placeholder: Search results for N8.Chat
Install the Plugin
Click the Install Now button. WordPress will download and install the plugin automatically.
Screenshot placeholder: Install Now button
Activate the Plugin
Once installed, click the Activate button. You'll see a success message and N8.Chat will appear in your admin menu.
Screenshot placeholder: Activate button and success message
Method 2: Manual Upload
If you have a custom version or need to install offline, you can upload the plugin manually.
Download the Plugin
Download the latest N8.Chat plugin ZIP file from the WordPress Plugin Directory or your account dashboard.
Tip: Make sure you download the ZIP file and don't extract it yet.
Upload via WordPress Admin
Go to Plugins → Add New → Upload Plugin
Click Choose File, select the ZIP file you downloaded, and click Install Now.
Screenshot placeholder: Upload Plugin interface
Alternative: FTP Upload
If you prefer using FTP, extract the ZIP file and upload the entire folder to:
/wp-content/plugins/n8chat/Then go to Plugins → Installed Plugins and activate N8.Chat.
Initial Configuration
After activation, configure N8.Chat to connect with your n8n workflow.
Access Plugin Settings
In your WordPress admin menu, click on N8.Chat to access the settings page.
Choose a Template
Select from 20+ professionally designed chat templates including ChatGPT, Claude, Notion, Linear, and more.
Screenshot placeholder: Template selection interface
Customize Appearance
Adjust colors, position, and branding to match your site. Changes are reflected in the live preview instantly.
Connecting to n8n Webhook
To enable chat functionality, connect N8.Chat to your n8n workflow.
Enter Your Webhook URL
Paste your n8n webhook URL in the Webhook URL field. It should look like:
https://your-n8n-instance.com/webhook/chat-webhook-idNote: Don't have an n8n workflow yet? Check out our n8n Configuration Guide to set one up.
Once configured, click Save Settings and test your chat widget by clicking the preview button.
Troubleshooting Common Issues
Plugin doesn't appear after activation
- •Clear your browser cache and refresh the page
- •Check if there are any plugin conflicts by temporarily deactivating other plugins
- •Ensure your WordPress user has Administrator role
Chat widget not showing on the front-end
- •Verify the widget is enabled in N8.Chat settings
- •Check display rules (pages, posts, or site-wide)
- •Clear your site cache if using a caching plugin
- •Check browser console for JavaScript errors
Messages not reaching n8n
- •Verify your webhook URL is correct and the n8n workflow is active
- •Check n8n workflow execution logs for errors
- •Ensure your n8n instance is publicly accessible
- •Test the webhook URL directly using curl or Postman
Installation fails or times out
- •Try the manual FTP installation method instead
- •Check your server's PHP memory limit and increase if needed
- •Contact your hosting provider if issues persist
Still Having Issues?
Check our FAQ or contact our support team. We're here to help!
Next Steps
Now that N8.Chat is installed, configure your n8n workflow to handle chat messages and create intelligent AI conversations.
Configure n8n Workflow