2020-10-29 15:09:12 +00:00
---
2020-11-27 18:09:52 +00:00
stage: Create
group: Ecosystem
2020-11-26 06:09:20 +00:00
info: To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/engineering/ux/technical-writing/#assignments
2020-10-29 15:09:12 +00:00
---
2016-01-09 19:30:34 +00:00
# Akismet
2020-11-16 18:09:15 +00:00
GitLab leverages [Akismet ](https://akismet.com/ ) to protect against spam.
2016-07-18 23:17:43 +00:00
GitLab uses Akismet to prevent the creation of spam issues on public projects. Issues
2020-11-16 18:09:15 +00:00
created through the web UI or the API can be submitted to Akismet for review.
2016-01-09 19:30:34 +00:00
2020-11-16 18:09:15 +00:00
Detected spam is rejected, and an entry is added in the **Spam Log** section of the
Admin page.
2016-07-16 16:42:44 +00:00
2020-05-26 12:08:22 +00:00
Privacy note: GitLab submits the user's IP and user agent to Akismet.
2020-12-04 21:09:29 +00:00
NOTE:
2020-05-26 12:08:22 +00:00
In GitLab 8.11 and later, all issues are submitted to Akismet.
In earlier GitLab versions, this only applied to API and non-project members.
2016-01-09 19:30:34 +00:00
## Configuration
To use Akismet:
2020-11-16 18:09:15 +00:00
1. Go to the [Akismet sign-in page ](https://akismet.com/account/ ).
1. Sign in or create a new account.
1. Click **Show** to reveal the API key.
2019-12-17 06:07:59 +00:00
1. Go to **Admin Area > Settings > Reporting** (`/admin/application_settings/reporting`).
2020-11-16 18:09:15 +00:00
1. Select the **Enable Akismet** checkbox.
2018-11-13 00:39:21 +00:00
1. Fill in the API key from step 3.
1. Save the configuration.
2016-01-09 19:30:34 +00:00
![Screenshot of Akismet settings ](img/akismet_settings.png )
2016-08-04 17:29:43 +00:00
## Training
2020-11-16 18:09:15 +00:00
To better differentiate between spam and ham, you can train the Akismet
2016-08-04 17:29:43 +00:00
filter whenever there is a false positive or false negative.
2018-11-13 00:39:21 +00:00
When an entry is recognized as spam, it is rejected and added to the Spam Logs.
2020-11-16 18:09:15 +00:00
From here you can review if entries are really spam. If one of them is not really
2018-11-13 00:39:21 +00:00
spam, you can use the **Submit as ham** button to tell Akismet that it falsely
2016-08-04 17:29:43 +00:00
recognized an entry as spam.
![Screenshot of Spam Logs ](img/spam_log.png )
2020-11-16 18:09:15 +00:00
If an entry that is actually spam was not recognized as such, you can also submit
this information to Akismet. The **Submit as spam** button is only displayed
to administrator users.
2016-08-04 17:29:43 +00:00
![Screenshot of Issue ](img/submit_issue.png )
2020-11-16 18:09:15 +00:00
Training Akismet helps it to recognize spam more accurately in the future.