vB5 Manual and API Documentation
Forums API Toggle Dark/Light/Auto mode Toggle Dark/Light/Auto mode Toggle Dark/Light/Auto mode Back to homepage

User Banning Options

Enable Banning Options

Banning allows you to stop certain IP addresses and email addresses from registering and posting to the forum.

  • Variable Name: enablebanning
  • Data Type: boolean
  • Default Value: 1

Banned IP Addresses

Use this option to prevent certain IP addresses from accessing any part of your board.

If you enter a complete IP address (, only that IP will be banned.
If you enter a partial IP (243.21.11. or 243.21.11), any IPs that begin with the partial IP will be banned. For example, banning 243.21.11 will prevent from accessing your board. However, would still be able to access your board.

You may also use an ‘’ as a wildcard for increased flexibility. For example, if you enter 243.21.11, many IPs will be banned including:,,

Place a space or a line break between each IP address.

  • Variable Name: banip
  • Data Type: free
  • Default Value:

Banned Email Addresses

Email address ban lists: You may ban any email addresses from registering and posting. Type in the complete email address ([email protected]), or use a partial email address (as in @example.com).

Note that partial email addresses are matched from the end of the address unless you enable ‘Aggressive Email Banning’ below. Therefore if you ban @example.com you will ban [email protected], but if you ban @example that user will not be banned. If you enable ‘Aggressive Email Banning’, [email protected] would be banned by @example.

If the email address of a user attempting to register or change their email address matches any of the addresses you specify here will see a no-permission error. For example, if you have banned ’example.com’ then a user attempting to use ‘[email protected]’ will be rejected.

Put a space between each email address or email address fragment.

  • Variable Name: banemail
  • Data Type: free
  • Default Value:

Aggressive Email Banning

If this option is enabled, when checking for banned emails, incomplete addresses are matched anywhere in the email address, not just the end.

For example, if this option is enabled ‘yahoo’ will block any email address with ‘yahoo’ in it. If this option is disabled, no emails will be banned unless the ban was changed to ‘yahoo.com’.

  • Variable Name: aggressiveemailban
  • Data Type: boolean
  • Default Value: 0

Allow User to Keep Banned Email Addresses

If you ban an email address and a user already uses that address, a problem will occur. Using this option, you can specify whether the user will have to enter a new email address in their profile when they next modify their email address, or whether the user can just keep the email address which you have banned.

  • Variable Name: allowkeepbannedemail
  • Data Type: boolean
  • Default Value: 1

Global Ignore

This option allows you to effectively add a user or users to every member’s ‘Ignore List’. However, users in this list can still see their own posts and topics…

Enter a list of userid numbers, separated by spaces (for example: 4 12 68 102).

If you change this option, you need to rebuild topic and then forum information here.

  • Variable Name: globalignore
  • Data Type: free
  • Default Value:

updated: 2022-08-29 09:50am | Version: 5.7.0 Alpha 4