Simple recommended settings for a clean and search-friendly phpBB setup
After installing phpBB SEO Framework Lite, you will find the Framework settings inside the phpBB Administration Control Panel.
This guide explains the most important settings in simple terms, what they do, and what we recommend for most phpBB communities.
You do not need to change every option.
For a new installation, the default settings are a good starting point.
1. SEO Permalinks
Permalinks control how your public phpBB URLs are displayed.
Instead of a native phpBB URL such as:
Code: Select all
viewtopic.php?t=123Code: Select all
/topic/example-topic-123/Code: Select all
viewforum.php?f=5Code: Select all
/forum/support-forum-5/Keep the default permalink structure unless you have a specific reason to change it.
Why is this useful?
Clean URLs are easier for users to understand, easier to share, and provide a consistent canonical URL for search engines.
Tip:
Avoid changing your URL structure repeatedly after your site has already been indexed.
2. Topic & Forum Slugs
A slug is the readable part of an SEO URL.
Example topic title:
Code: Select all
How to Install phpBB SEO FrameworkCode: Select all
/topic/how-to-install-phpbb-seo-framework-123/If a topic title changes later, the Framework can keep track of the previous slug and redirect old URLs to the current canonical URL.
Why is this useful?
Old links from Google, bookmarks, or other websites are less likely to become broken URLs.
3. Titles & Meta
Enable the Titles & Meta Engine.
This controls the HTML title and meta description that search engines can use for your pages.
A topic can produce a title such as:
Code: Select all
How to Install phpBB SEO Framework Lite - phpBB SEOCode: Select all
Installation & Configuration - phpBB SEOCode: Select all
{topic_title} - {site_name}Code: Select all
{forum_name} - {site_name}Code: Select all
160The title is one of the most important pieces of information search engines use to understand a page.
A good meta description can also make your search result easier to understand and more attractive to users.
Tip:
Keep titles natural. Do not repeat the same keyword many times.
A separate detailed Titles & Meta guide will cover tokens and advanced patterns.
4. Automatic Topic Meta Descriptions
When a custom description is not provided, the Framework can generate a clean description from topic content.
phpBB formatting and BBCode are cleaned before the final description is created.
For example:
Code: Select all
[b]How to Install phpBB SEO[/b]
This guide explains the installation process.Code: Select all
How to Install phpBB SEO. This guide explains the installation process.You do not have to manually write a meta description for every discussion on a large forum.
5. Canonical URLs
Canonical URLs tell search engines which URL should be treated as the main version of a page.
Example:
A native URL:
Code: Select all
viewtopic.php?t=123Code: Select all
/topic/example-topic-123/The SEO URL becomes the canonical version.
Recommended:
Keep canonical URL handling enabled.
Why is this useful?
It helps prevent duplicate URL variants from being treated as separate pages by search engines.
6. Automatic 301 Redirects
The Framework can redirect old or native URLs to their current SEO URL.
Example:
Code: Select all
viewtopic.php?t=123Code: Select all
/topic/example-topic-123/Old slugs can also redirect to the current slug.
Why is this useful?
It consolidates visitors and search engine signals onto one preferred URL instead of splitting them between multiple versions.
7. Pagination
Multi-page topics and forums receive clean page URLs.
Example:
Code: Select all
/topic/example-topic-123/page/2/You normally do not need to configure anything manually after the permalink system is working.
Why is this useful?
Page 2, page 3, and later pages remain accessible through consistent URLs instead of falling back to broken or duplicate paths.
8. XML Sitemap
The Framework generates XML sitemaps that help search engines discover public phpBB content.
Your main sitemap is normally available at:
Code: Select all
https://example.com/sitemap.xmlRecommended:
Keep the sitemap enabled for public content you want search engines to discover.
Why is this useful?
Large forums can contain thousands or millions of URLs. A sitemap gives search engines a structured way to discover them.
You can later submit the sitemap URL to Google Search Console.
9. Member & Group URLs
The Framework can also create clean URLs for supported member profiles and groups.
Example member:
Code: Select all
/member/admin-2/Code: Select all
/group/global-moderators-4/SEO note:
Whether all member profile pages should be indexed is a separate SEO decision.
Large forums may prefer more restrictive indexing rules for low-value profile pages.
10. Web Server Rewrite Configuration
SEO URLs require the correct rewrite configuration on your web server.
Supported servers include:
Apache 2.4+
LiteSpeed
Nginx
If native phpBB URLs work but SEO URLs return:
Code: Select all
404 Not FoundImportant:
Do not copy rewrite.php to the phpBB root directory.
It must remain inside:
Code: Select all
ext/phpbbseo/framework/rewrite.php11. ACP Update Checker
The Framework ACP can check the official GitHub Releases repository for newer Lite versions.
The current installed version is shown in the ACP.
If a newer release is available, the Framework can display an update notification with the official release link.
Update checks are cached and do not run during normal frontend browsing.
Why is this useful?
SEO and compatibility fixes can be important, so administrators can quickly see when a newer Framework release is available.
12. Recommended Settings for Most Forums
For a normal phpBB community, a safe starting configuration is:
13. After Saving Your Settings
After changing important SEO settings, purge the phpBB cache:
Code: Select all
ACP → General → Purge the cacheAlso test a native URL such as:
Code: Select all
viewtopic.php?t=123If your forum is already established and indexed by search engines, avoid changing URL patterns simply for appearance.
A URL structure that has already been indexed may have backlinks, bookmarks, and search engine history.
If you are unsure, ask before changing permalink patterns.
For more detailed configuration, see the dedicated guides for:
phpBBSEO.com
GitHub Repository
— phpBB SEO Team