Abuse filter manager

From Meta, a Wikimedia project coordination wiki
Jump to navigation Jump to search
Policies and guidelines Abuse filter manager policy & information
This page outlines the standards and guidelines related to the Abuse filter manager and their use of their rights to manage Abuse filters globally.

The following is a proposed Wikimedia document. References or links to this page should not describe it as supported, adopted, common, or effective. The proposal may still be in development, under discussion, or in the process of gathering consensus for adoption (which is not determined by counting votes).

The Abuse filter manager is a global user group assigned by stewards that permits trusted users access to view, and where appropriate, edit abuse filters. This permission is enabled on every public Wikimedia wiki that shares access via CentralAuth and SUL, and is only to be used for non-controversial maintenance, or by request of the local community. Since users in this group can seriously disrupt Wikimedia wikis if used incorrectly, the abuse filter editor permission is only assigned to users who have a strong track record in maintaining abuse filters.


Use of rights[edit]

This global group is enabled on every Wikimedia wiki that shares access via CentralAuth and SUL (including locked (closed) wikis and excluding private and fishbowl wikis). Abuse filter managers must not make any controversial changes to filters on any project. Essentially, unless explicitly requested or endorsed by the community, abuse filter managers should not change the functionality of filters. Instead they should use their rights solely for maintenance such as preventing a filter from breaking due to upcoming changes to the AbuseFilter extension itself. Notes should be left in the filter description explaining why the change was needed, and listing the relevant Phabricator tasks if applicable.

Abuse filter managers should avoid making routine changes to the filters on larger projects without prior notification and agreement. Projects with established communities and processes for maintaining abuse filters can request to be avoided (i.e. "opt out"), in which case they should provide abuse filter managers with appropriate guidelines about how to notify them of the necessary changes so that they can be applied by the local community. Examples may include a link to the "village pump" page, a mailing list, or requesting the abuse filter manages to contact a local sysop through in-wiki email.

Proposed rights[edit]

  • View the abuse log (abusefilter-log)
  • View detailed abuse log entries (abusefilter-log-detail)
  • View log entries of abuse filters marked as private (abusefilter-log-private)
  • Modify abuse filters (abusefilter-modify)
  • Create or modify global abuse filters (abusefilter-modify-global)
  • Modify abuse filters with restricted actions (abusefilter-modify-restricted)
  • View abuse filters (abusefilter-view)
  • View abuse filters marked as private (abusefilter-view-private)

Rights specifically not proposed[edit]

  • View private data in the abuse log (abusefilter-private)
  • View the AbuseFilter private details access log (abusefilter-private-log)
  • View hidden abuse log entries (abusefilter-hidden-log)
  • Hide entries in the abuse log (abusefilter-hide-log)
  • View the spam blacklist log (spamblacklistlog)
  • Revert all changes by a given abuse filter (abusefilter-revert)


Requests for abuse filter managers rights should be placed on Steward requests/Global permissions. The request will be approved by a steward if there is a consensus for the user to become an abuse filter manager after a period of discussion of no less than one week. The discussion is not a vote; comments must present specific points in favor of or against the user's approval.

As a guideline, abuse filter managers should:

  • Hold sysop or abuse filter helper (where exists) on their homewiki
  • Have extensive experience with AbuseFilter: created or edited several filters
  • Has contributed to the AbuseFilter code and participates in the relevant discussions on Phabricator

By default, appointment will be temporary, lasting any time up to a year, and will be added to Steward requests/Permissions/Approved temporary. Requests for renewal can be done by placing a new request on Steward requests/Global permissions#Requests for other global permissions.


Continued access to abuse filters is dependent on activity and community trust.

  • Misuse or abuse: If this permission is used for any actions which are controversial, such as major additions or removals to a project's abuse filter, or continued disruption due to errors, access will be revoked by a steward. Requests can be made to any steward by placing a request on Steward requests/Permissions#Removal of access or, in emergencies, the #wikimedia-stewardsconnect IRC channel.
  • Inactivity: If an abuse filter manager has made no global edits for six months, the permission may be revoked by a steward.

Review of a abuse filter manager's actions can be requested from any steward or via requests for comment.

See also[edit]