Board Settings

This page covers the settings that are included with MyBB. For information regarding the Settings section in general, including adding and editing your own settings and setting groups, see Admin CP: Settings.

Contents

This setting group allows you to turn your MyBB forum on and off. You may also specify a reason for turning them off.

Board Closed 
If this is set to yes, the forum will display the Board Closed Reason. Only Administrators will be able to access the forum.
Board Closed Reason 
A reason for closing your forum. This field will only be shown if the "Board Closed" setting is set to "Yes," meaning the forum is closed.

This setting group contains various settings configuring your entire MyBB forum as a whole. In the General Configuration area you can control your forum's name, URL, cookie path, contact email and more.

Board Name 
The name of your board.
Board URL 
This is the full URL to your board without the trailing (last) slash (/).
Correct: http://www.mysite.com/mybb
Incorrect: http://www.mysite.com/mybb/
Homepage Name 
The name of your website, displayed in the default footer as a link to your website
Homepage URL 
The link to your website. See Homepage Name above.
Admin Email
When the board generates automatic email notifications, the mails are sent from this address.
Return Email 
This email address is used for incoming replies to outgoing emails sent via the forums, this email address is used. If this field is empty, the Admin Email will be used. See Admin Email above.
Contact Us link 
A link in the default footer for users to contact you or your staff. This can either be a URL (for example, "contact.php") or an email address (in the form of "mailto:your@email.com"). By default, this is filled in with a link to the admin email address.
Default Language 
The language displayed on the board by default that guests and users who have not set their language setting will see.
Cookie domain 
This should be in the form of ".mysite.com" without the quotes. Alternatively, it can be left blank. If your users are having problems logging in, check your cookie settings. See Cookie Settings for more information.
Cookie path 
This should be in the form of "/folder/to/mybb/" without the quotes. See Cookie Settings for more information.
Cookie Prefix 
This is a prefix for all cookies used by MyBB on your forum. This can be useful for possible conflicting cookies, such as having multiple copies of MyBB installed on one domain or having a software with conflicting cookies installed. Leaving this blank will not use a prefix.
Show Version Numbers 
Allows you to turn off the public display of version numbers in MyBB. This is best disabled for security reasons.
CAPTCHA Images for Registration & Posting 
If yes, and GD is installed, an image will be shown during registration and guest posting where users are required to enter the text contained within the image to continue. This helps prevent automated registrations and postings.
Reported Posts Medium 
When a user reports a post to the moderators, the report will be sent to one of the options you select here. Storing in a database is the default option and is recommended.
Stats Limit 
The number of threads to be shown on the statistics page for most replies and most views. By default, this is set to 15.
Decimal Point 
The decimal point you use in your region.
Thousands Numeric Separator 
The punctuation you want to use to separate large numbers. (For example, the setting ',' with the number 1200 will give you a number such as 1,200)
Show Language Selector in Footer 
If you wish to allow users and guests to change their language via a selector in the footer, set to yes. This is best for forums that have multiple languages installed.
Maximum Page Links in Pagination 
The maximum number of next and previous page links to be shown when there is more than one page of results. This does not limit the number of pages, but the number of links shown at a time.
Mailing Address 
The mailing address COPPA forms can be sent to. This is only necessary if you have COPPA enabled.
Contact Fax No 
The fax number COPPA forms can be sent to. This is only necessary if you have COPPA enabled.

These options allow you to set various server and optimization preferences allowing you to reduce the load on your server, and gain better performance on your board. Please keep in mind that all servers aren't the same, some settings should be left disabled. If your not sure if your server can handle some of the settings, please contact your host.

Enable Search Engine Friendly URLS 
Search engine friendly URLs allows links to be shorter and easier to type, such as showthread.php?tid=1 becoming thread-1.html. Your server must support mod_rewrite in order for this to work properly. See the Search Engine Friendly URLS article for more information. By default, this is set to automatically detect, where MyBB checks to see if your server can support it; however, this may not always work. You can also enable or disable this feature.
Use GZip Page Compression 
If this is set to yes, content sent to the user's browser will be compressed for a quicker download and use less bandwidth.
GZip Page Compression Level 
The level of GZip compression, if GZip compression is enabled. 0 is no compression, whereas 9 is maximum compression.
Send Standard Headers 
If this is set to yes, these headers will be sent:
HTTP/1.0 200 OK
HTTP/1.1 200 OK
Content:type: text/html
Send No Cache Headers 
If this is set to yes, these headers will be sent:
Expires: Sat, 1 Jan 2000 01:00:00 GMT
Last:Modified: " . gmdate("D, d M Y H:i:s") . "GMT
Cache:Control: no:cache, must:revalidate
Pragma: no:cache
Friendly Redirection Pages 
If this is set to on, redirection messages will be displayed. If not, then the user will be directly transfered to the resulting page without a redirect message. Users can also set this in their User CP.
NIX Load Limiting 
  • If you are concerned about having too high a server load, you can use this setting to set a limit. If your server goes over the server load limit you set, then MyBB will reject the user until the server load falls back down below the limit.
Output template start/end comments? 
This will enable or disable the output of template start/end comments in the HTML. Start/end comments appear directly before a template begins and directly after a template ends.
Enable XMLHttp request features 
Should any features using XMLHttp requests (AJAX features) be enabled?
Use PHP's Shutdown Functionality 
This setting for the most part is best left at the default which is detected upon installation. If thread indicators are not updating as well as other meta information, set this setting to 'No'
Advanced Stats / Debug information 
Shows server load, parse time, generation time, Gzip compression, et cetera on the bottom of all pages in the root folder. Please note that only administrators see this information.
Uploads Path 
This is the path to the uploads folder. Attachments and uploaded avatars are saved in this directory and therefore must be CHMODed 777 (world writable) on Unix/Linux servers.
Use Error Handling 
To use MyBB's integrated error handling, this needs to be enabled. It is recommended this remains enabled.
Error Logging Medium 
How should errors be logged, if they are logged? You can have them logged to a file, sent to an email address, both, or neither.
Error Type Medium 
What types of errors should be shown? Should warnings, errors, or both be shown?
Error Logging Location 
If error logging is enabled, what is the location of the error log?
Enable Forum Jump Menu 
The forum jump menu provides quick access to other forums and pages from the forum and thread pages. If you have a large number of forums, it can add a large load to your forums. Setting to 'No' disables the forum jump menu.

Here you can specify the different date and time formats used to display dates and times on the forums. These settings use the PHP date() function, so we don't recommend changing this unless you know what you're doing.

Date Format 
This is the format shown for dates in the forum.
Time Format 
This is the format shown for times in the forum.
Registered Date Format 
This is the format shown when a user makes a post for the date registered (for example, Registered: Apr 2005)
Default Timezone Offset 
When users register, this will be the timezone selection by default.
Day Light Savings Time 
If times are an hour out above and your timezone is selected correctly, enable day light savings time correction.

This section allows you to manage the various settings used on the forum home (index.php) of your boards such as enabling and disabling different features such as Today's Birthdays, Hide Private Forums, Show Who's Online, and more.

Show Forum Descriptions 
This option allows you to change whether or not forum descriptions are shown below each forum on the homepage.
Subforums To Show On Index Listing 
If a forum has a number of subforums, the number of subforums for that forum shown on the homepage is controlled by this setting. Set to 0 to now show the subforum list.
Show Subforum Status Icons? 
Show icons indicating whether or not a subforum contains new posts or not? This won't have any effect unless you enabled subforums display on the index.
Hide Private Forums 
If this setting is set to "yes" and the user does not have permission to view the forum, then the forum will be hidden to them. If this is set to no, then all users will see all forums on the forum list, but will not be able to view the the thread listings if they do not have the permissions to.
Forums Moderator Listing 
If this is set to "yes," a list of moderators for each forum will be shown below the forum name, if the forum has moderators.
Show Today's Birthdays 
Show user birthdays at the bottom of the homepage.
Show Who's Online 
If this is set to "yes," then a list of users currently online will be shown at the bottom of the forum homepage.
Show Small Stats Section 
Show a summary of the forum statistics at the bottom of the forum homepage (total members, total threads, total posts, newest member, etc).
Show x viewing forum 
Should the current number of users viewing each forum be shown on the forum home?

This section allows you to manage the various settings used on the forum display (forumdisplay.php) of your boards. This includes enabling and disabling different features, such as replies and views for a hot topic, threads per page, and more.

Threads Per Page 
The number of threads shown for each "page" of the forum by default.
Replies For Hot Topic 
The number of posts needed in a thread to be considered "hot"
Views For Hot Topic 
The number of views needed for a thread to be considered "hot"
User Selectable Threads Per Page 
Users will be able to choose how many threads per page they want displayed from the list of numbers in this setting. Separate numbers with a comma.
Use "Dot" Icons 
If this is set to "yes," if a user has posted in a thread, then the thread will have a special icon indicating that the user has posted in the thread previously.
Users Browsing This Forum 
If enabled, this will show a list of users viewing the thread list at the top of the forum.
Announcements Limit 
If there are active announcements in the forum, this setting will limit how many show up on the thread listing.

This section allows you to manage the various settings used on the thread display page (showthread.php) of your boards such as enabling and disabling different features such as post layout (horizontal versus classic post layout), posts per page, maximum avatar dimensions in posts, and more.

Post Layout 
Which layout should posts be shown in by default? You can either select the horizonal post layout where author information is shown above the post or the classic layout where the author information is shown to the left of the post. Users can also choose to use the classic layout via their User CP.
Posts Per Page 
The number of posts shown for each "page" of the thread by default
User Selectable Posts Per Page 
Users will be able to choose how many posts per page they want displayed from the list of numbers in this setting. Separate numbers with a comma.
Maximum Avatar Dimensions in Posts 
The maximum size (in pixels) for avatars in posts. Avatars larger than this size will be scaled down. This is not the maximum dimensions for avatars users can upload, but for their display in posts.
Read Threads in Database (Days) 
This is the number of days you want to keep the data of what threads the user has read. Set to 0 to disable.
Usenet Style Thread View 
If selected, the display style of the thread will be converted to USENET style.
Show Quick Reply Form 
Should the quick reply form be shown at the bottom of threads? It is only displayed to users who have it enabled in their User CP and those with permissions to post.
Show Multi-quote buttons 
Should users be allowed to select multiple posts for quoting? Users select posts via the multi-quote buttons and then can either load them into the quick reply form, or have them appear when posting a reply to a thread or posting a new thread.
Show "Similar Threads" table 
If enabled, a listing of similar threads will be displayed at the bottom of the thread.
Delayed Thread View Updates 
If this setting is enabled, thread view counts will be updated using the task scheduling system. Otherwise, they will be incremented instantly. Note: The 'Thread Views' task must be enabled for this to work. This task should be automatically enabled or disabled when changing this setting.

Here you can control various settings with relation to user account registration and account management.

Disable Registrations 
Should new registrations be disabled? Set to 'No' to allow registrations.
Registration Method 
When registering an account, should users be activated instantly, be sent an email activation, be sent a random password, or be activated by an administrator?

Instant Activation: As soon as a user registers an account, they can post threads, replies etc without having to verify their email.
Email Activation: When users register an account, they are required to click a link that is sent to their email to verify their email.
Random Password: An email is sent to the users email address with a random password that they use to log in.
Administrator Activation: All users must be activated by an administrator.

When it says awaiting activation in the ACP, it means the user has registered but has not clicked the activation link that they received in the welcome email.

Minimum Username Length 
The minimum number of characters a user's username can be. A username with any less than this number of characters cannot be registered.
Maximum Username Length 
The maximum number of characters a user's username can be. A username with any more than this number of characters cannot be registered.
Minimum Password Length 
The minimum number of characters a user's password can be. A password with any less than this number of characters cannot be registered.
Maximum Password Length 
The maximum number of characters a user's password can be. A password with any more than this number of characters cannot be registered.
Custom User Title Maximum Length 
The maximum number of characters a user's custom user title, if enabled, can be. Any custom user title with more than this number of characters cannot be used.
Time Between Registrations 
The amount of time, in hours, between registrations using the same IP address.
Allow emails to be registered multiple times 
Should a single email address be allowed to be registered more than once?
Maximum Registrations Per IP Address 
The maximum number of registrations a user can register while using a single IP address.
Numeber of times to allow failed logins 
The number of failed logins allowed before they are locked out. Set to 0 to disable.
Time between failed logins 
The amount of time between a user can try to login again after having been locked out.
Display number of failed logins 
Should the user be shown the number of login attempts they have?
User Referrals System 
Should users be able to specify a referrer when registering?
Allow MyCode in Signatures 
Should MyCode be allowed in user's signatures?
Maximum Number of Images per Signature 
The maximum number of images a user can put in their signature, including smilies. Set to 0 to disallow images in signatures.
Allow Smiles in Signatures 
Should users be able to use smilies in their signatures?
Allow HTML in Signatures 
Should HTML be allowed in user's signatures?
Allow [img] Code in Signatures 
Should users be able to use the [img] code in their signatures?
Length limit in Signatures 
The maximum numbers of characters a user can put in their signature. Any signature with more than this number of characters will not be allowed.
MyCode affects signature length 
Should MyCode placed in a signature count towards the character limit?
Maximum Avatar Dimensions 
The maximum dimensions of avatars users can upload in pixels and the format of widthxheight. Leaving this blank allows no restriction.
Max Uploaded Avatar Size 
The maximum file size of uploaded avatars in kilobytes.
Avatar Resizing Mode 
Should avatars over the maximum dimensions be resized when uploaded? You can choose to automatically resize all large avatars, give users the option of resizing large avatars, or disable avatar resizing.
Users Keep Email 
If an already registered user has an email address that is in your banned list, should they be allowed to keep it?
COPPA Compliance 
You can choose to require the user's birthday, to comply with the COPPA regulations. You can choose to "Disable this feature" (does not require date of birth), "Enabled" (require a COPPA form to be submitted for users under the age of 13, and require date of birth on registration), or "Deny users under the age of 13" (require date of birth on registration, and deny any under the age of 13).
Allow Away Statuses 
If set to yes, users can set themselves as away (which is shown in the postbit), as well as specify a return date and a reason (which is shown in the user's profile).

These options control the various elements in relation to posting messages on the forums. There are 15 settings you can enable or disable.

Minimum Message Length 
Posts must have at least this number of characters in order to be accepted.
Maximum Message Length 
Users cannot post more than this amount of characters in one post. Entering 0 allows an unlimited length.
Maximum Posts Per Day 
Users cannot post more than this amount of posts in 24 hours. Entering 0 allows unlimited posts per day.
Post Flood Checking 
Setting this to "On" forbids a user from posting until a set number of seconds have passed after their previous post. The time is set in the following setting.
Post Flood Time 
Users must wait this amount of time in order to post again (the setting above must be set to "On")
Post Merge Time 
Posts made within so many minutes of each other (by the same user) will be automatically merged together. In this setting, you set the number of minutes until posts are no longer merged (meaning those made within x minutes will be merged). Set this to 0 or leave it blank to disable the feature.
Merge Forums to Ignore 
The forum IDs to exclude from the auto merge feature (the setting above). Separate by a comma, and leave blank to merge double posts in all forums.
Merge User Groups to Ignore 
User group IDs that will not be excluded from automatic merging of double posts. The default for this setting is 4, which corresponds to the Adminstrator group.
Merge Separator 
The separator that will be used when merging double posts. The default is [hr].
Log Posting IP Address 
This setting controls whether or not IP addresses of the post author are saved, and to whom they are shown to.
Show "Edited by" Messages 
When a user edits his/her posts, this setting controls whether or not a small message at the bottom of the post logs the edit author and edit time (of the most previous edit).
Show "Edited by" Messages for Forum Staff 
This is the same as the Show "Edited by" Messages setting, but for those specified as forum staff - most typically Adminstrators, Super Moderators, and Moderators.
Maximum Images Per Post 
This setting limits the number of images and smilies that a user can post in one message.
Amount of Characters for Subscription Previews 
The number of characters of a post to be sent with email notification of a new reply.
Maximum Attachments Per Post 
This setting limits the number of files a user can attach to one post.
Show Attached Thumbnails In Posts 
You can choose to show attached images in posts as either a thumbnail, the full size image, or as a download link.
Attached Thumbnail Maximum Height 
The maximum height that a thumbnail can be generated at for an attached image
Attached Thumbnail Maximum Width 
The maximum width that a thumbnail can be generated at for an attached image
Edit Time Limit 
After the set number of minutes, regular users will not be able to edit their posts (if they have the permission to). Entering 0 will allow for no limit. This setting does not affect forum staff, most typically Administrators, Super Moderators, and Moderators.
Number of Characters before Word Wrapping Occurs 
The number of characters in a word before a space is automatically inserted (to help preserve the forum layout). Setting to 0 will disable this feature.
Maximum Poll Option Length 
Users cannot have poll options longer than this number of characters. Setting to 0 disables the limit.
Maximum Number Of Poll Options 
Users cannot post more than this number of poll options in a single poll
Show Thread Review 
Should the 10 most recent posts in the thread be shown when posting a reply?

This section allows you to control various aspects of the board member listing (memberlist.php), such as whether to enable the member list, the number of members per page, and sort orders.

Enable Member List Functionality 
Should the member list be enabled?
Members Per Page 
The number of members shown per page.
Default Sort Field 
The field members should be sorted by default, including "Registration Date," "Post Count," "Username," and "Last Active."
Default Sort Order 
Display in ascending (A-Z, beginning to end) or descending (Z-A, end to beginning) order?
Maximum Display Avatar Dimensions 
The maximum dimensions for the avatars displayed on the member list. If an avatar is larger than these dimensions, it will be scaled down. This does not limit the size of avatars users can upload, but instead the size of already uploaded avatars displayed on the member list.

The reputation system allows users to give feedback on other users.

Enable Reputation Functionality 
To completely disable reputation and all traces of it, set this to "No"
Reputation Comments Per Page 
The number of comments to be displayed per page on a user's reputation page.

The warning system allows forum staff to warn users for rule violations and keep track of these warnings.

Enable Warning System 
Set to no to disable the warning system and remove all traces of it.
Allow Custom Warning Types 
Should those allowed to give permissions also be allowed to specify a custom warning type when warning a user?
Can Users View Own Warnings 
Should users be able to view recent warnings in their User CP and see their warning level in their profile?
Maximum Warning Points 
The number of warning points given to a user before their warning level is considered 100%.

The show forum team page (showteam.php) lists all of those considered "forum staff," typically Administrators, Super Moderators, and Moderators.

Separate Group Leaders 
Setting to yes displays group leaders above the other group members on the forum team page.

Various options relating to the MyBB private messaging system (private.php), which allows users to send private notes to each other

Enable Private Messaging Functionality 
To disable private messaging and remove all traces of it, set this option to "No."
Allow HTML 
Show users be allowed to use HTML in private messages? It is recommend you keep this disabled for security reasons.
Allow MyCode 
Should users be allowed to use MyCode in their private messages?
Allow Smilies 
Should users be allowed to use Smilies in their private messages?
Allow [img] Code 
Should users be allowed to use images in their private messages using the [img] MyCode?

MyBB's calendar allows for the posting of ranged and repeating events to multiple calendars. Each calendar has it's own settings. For more information on managing calendars, see Admin CP: Calendars

Enable Calendar Functionality 
To disable the calendar completely, set this setting to "No."

Settings relating to the Who's Online page (online.php).

Cut-off Time (mins) 
The time before a user is marked as offline (after their last activity on the forum).
Refresh Who's online page time (mins) 
The number of minutes before the "Who's Online" page refreshes. Setting this to 0 disables refreshing. Use 0.5 for 30 seconds.

Settings relating to the forum portal (portal.php), such as what to show and the forums announcements should be pulled from.

Forum ID to pull announcements from 
The forums to pull the latest threads from for the announcements portion on the portal. Separate multiple forums by a comma.
Number of announcements to show 
The number of announcements shown on the portal.
Show the Welcome box 
Should the welcome box be shown to visitors and users?
Show the number of PMs to users 
Should the number of private messages the current user has be displayed?
Show forum statistics 
Should the number of posts, threads, members, and the newest member be displayed?
Show Who's Online 
Should the who's online information be displayed?
Show Search Box 
Should a search box be displayed?
Show Latest Discussions 
Should the latest threads be displayed?
Number of latest discussions to show 
The number of latest threads to be shown.

Settings relating to the built-in search mechanism for threads and posts (search.php).

Search Type 
The type of search system you wish to use, either "Standard" or "Full Text." Full text searching is more powerful and quicker.
Search Flood Time (seconds) 
The number of seconds until a user can make another search. Setting to 0 disables the search flood time.
Minimum Search Word Length 
The minimum number of characters each word must be in a query. Set to 0 to disable this setting. For standard searching, there is a hard limit of 3, and for full text searching, there is a hard limit of 4. The hard limit will always override the set limit if the set limit is lower than the hard limit.
Hard Limit for Maximum Search Results 
The maximum number of results to be processed in a search. This should be set to no higher than 1000 on boards with more than 1 million posts.

Settings relating to the appearance of the clikable smilie inserter and the MyCode editor.

Clickable MyCode Editor 
Should the MyCode editor be enabled?
Clickable Smilies Inserter 
Should the clickable smilies inserter be enabled?
No. of Smileis to Show 
The number of smilies to show on the clickable smilie inserter.
No. of Smilie Cols to Show 
The number of columns in the clickable smilie inserter.

Global preferences for the Admin Control Panel.

Control Panel Language 
The language of the control panel. Default is English.
Control Panel Style 
The Default style that the control panel will use. Styles are inside the styles folder. A folder name inside that folder becomes the style title.

Settings relating to the MyBB Mail system, such as whether to use PHP mail or an off server SMTP server.

Mail handler 
Use PHP mail or SMTP mail?
Additional Parameters for PHP's mail() 
Allows you to specify additional parameters in the PHP mail() function. More information can be found at the PHP website. This setting is only required when PHP mail is selected as the mail handler.
SMTP hostname 
The hostname of the SMTP server. This setting is only required when SMTP mail is selected as the mail handler.
SMTP port 
The port number of the SMTP server. This setting is only required when SMTP mail is selected as the mail handler.
SMTP username 
The username needed to authenticate with the SMTP server. This setting is only required when SMTP mail is selected as the mail handler.
SMTP password 
The corresponding password used to authenticate with the SMTP server. This setting is only required when SMTP mail is selected as the mail handler.
SMTP Encryption Mode 
The method of encryption required to communicate with the SMTP server. This is either "No encryption," "SSL encryption," or "TLS encryption." This setting is only required when SMTP mail is selected as the mail handler.