# WordPress Plugin Integration Guide
humanID’s WordPress Plugin allows users to permanently block users and bots from commenting on their WordPress-based website, or from sending you contact requests through your contact form (requires 'Contact Form 7'). Safe your time from having to go through emails and comments manually, and safe your users' time from having to solve ineffective CAPTCHAs.
## **Overview**
1. [Requirements](#_m5phaycvxyjt)
2. [Create your humanID Developer Account](#_534tbnfh1936)
3. [Plugin Setup in WordPress](#_h0dl1vv45boj)
4. [Developer Console Setup](#_8ytpmmjnrqt1)
5. [Success/Failure Links](#_3ts4raj2bk0z)
## **Requirements**
* A [humanID Developers account](https://developers.human-id.org/login/register/) (humanID is free up to several hundred monthly requests).
* humanID Server Credentials. Server Credentials consist of
* Server Client ID
* Server Client Secret.
* A website utilizing WordPress. You must be site admin or site creator.
### **Create your humanID Developer Account**
* Go to .
* Fill out the page with your information and click “Create Account”
### **Plugin Setup in WordPress**
* In the WordPress dashboard, find “plugins” and click “add new”.
* Search for “humanID”. Install and activate the plugin.
* In WordPress, go to “humanID Setup”
####
* In the “Update Permalinks” panel, click “Go to permalinks”.
* Set your “Common Settings” to anything other than type “Plain”. Do **NOT** set your common setting to be “Plain” and save changes.
* Back on the “humanID Setup” page, click “Yes, I have updated the permalinks”. This panel should appear.
### **Developer Console Setup**
* Below the “humanID Redirect Urls” panel, right-click on “here” and click “Open link in new tab”. Click on the new tab to go to the “humanID Developers” page.
* Log into your humanID Developers account. If you don’t have one, create one and log in.
* In the “humanID Developers” dashboard, click “Register New Project”
* Click “Create New Credentials”. Name your credentials, and set the type and environment (usually to 'Production' and 'Server'). Leave "Package ID" empty. After this step, you will receive server credentials on the dashboard.
* Copy your Client ID and on the “humanID Setup” page paste it into the textbox labeled “Client ID”.
* Copy your Client secret and on the “humanID Setup” page paste it into the textbox labeled “Client Secret ”. Save changes.
### **Success/Failure Links**
* In the “humanID Setup” page, find the redirect URLs you received after you updated your permalinks.
* Open the “humanID Developers” dashboard. Scroll down until you see the panel labeled “Redirect URLs”.
* Click the arrow on the right of “Edit Redirect URLs” to expand. Find “Successful URL” and “Failed URL”.
* Copy your success link from “humanID Setup” and paste it into their respective textbox on the “humanID developers” page.
* Repeat the step above with the failed link.
* Click “Update Project Redirect URLs”.
***
## humanID Contact Form Protection
If you're using the 'Contact Form 7' plugin, Wordpress' most popular Contact Form, you can upgrade it with humanID.
1. After installing 'Contact Form 7', go to the Wordpress menu.
2. Click on 'Add New' on top to add a new Contact Form
3. Enter a title, and then click on 'humanID' 
4. A menu will pop up to create a tag that will look something like \[humanid humanid-123]. Move this tag to the end of the form template.
5. You have now successfully added humanID to your Contact Form. Follow 'Contact Form 7's' guidelines to implement the Contact Form at the desired page on your website
## humanID Comment Form Protection
humanID's Comment form allows your website to host real debates between real humans – and allows you to block spam and harassment. You can blacklist offenders effectively, all without undermining your users' privacy. humanID's awardwinning technology blocks bots without saving any personally identifiable information.
To do so, no further work is needed. humanID is automatically added to Wordpress' in-house comment solution. After adding the plugin, you can permanently block users, or whitelist users. By default, comments will wait for your approval unless a user has been previously whitelisted.
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.human-id.org/wordpress-plugin-integration-guide.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.