{"id":14702,"date":"2026-02-19T22:10:25","date_gmt":"2026-02-19T16:40:25","guid":{"rendered":"https:\/\/www.huntbee.com\/resources\/docs\/seo-xml-sitemap-generator-pro\/htaccess-configuration\/"},"modified":"2026-03-02T13:33:05","modified_gmt":"2026-03-02T08:03:05","slug":"htaccess-configuration","status":"publish","type":"docs","link":"https:\/\/www.huntbee.com\/resources\/docs\/seo-xml-sitemap-generator-pro\/htaccess-configuration\/","title":{"rendered":".htaccess Configuration"},"content":{"rendered":"\n<p>The <code>.htaccess<\/code> configuration gives your sitemaps and AI feeds clean, SEO-friendly URLs. Without these rules, sitemaps are still accessible via full OpenCart route URLs, but clean URLs are preferable for search console submissions and readability.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">URL Mapping Reference<\/h2>\n\n\n\n<p>These are the rules the extension adds to your <code>.htaccess<\/code>:<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><th>Clean URL<\/th><th>Purpose<\/th><\/tr><\/thead><tbody><tr><td><code>\/sitemap_index.xml<\/code><\/td><td>Master sitemap index<\/td><\/tr><tr><td><code>\/sitemaps\/{lang}\/product_sitemap_{n}.xml<\/code><\/td><td>Paginated product sitemaps<\/td><\/tr><tr><td><code>\/sitemaps\/{lang}\/product_tags_sitemap_{n}.xml<\/code><\/td><td>Product tag sitemaps<\/td><\/tr><tr><td><code>\/sitemaps\/{lang}\/category_sitemap.xml<\/code><\/td><td>Category sitemap<\/td><\/tr><tr><td><code>\/sitemaps\/{lang}\/brand_sitemap.xml<\/code><\/td><td>Brand\/manufacturer sitemap<\/td><\/tr><tr><td><code>\/sitemaps\/{lang}\/information_sitemap.xml<\/code><\/td><td>Information pages sitemap<\/td><\/tr><tr><td><code>\/sitemaps\/misc_sitemap.xml<\/code><\/td><td>Miscellaneous \/ custom links<\/td><\/tr><tr><td><code>\/sitemaps\/{lang}\/journal3blog_sitemap.xml<\/code><\/td><td>Journal3 blog posts<\/td><\/tr><tr><td><code>\/ai_feed_index.json<\/code><\/td><td>AI feed manifest (index)<\/td><\/tr><tr><td><code>\/ai-feed\/{lang}\/ai_product_feed_{n}.json<\/code><\/td><td>Paginated AI product feed pages<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p><code>{lang}<\/code> = your language code (e.g., <code>en<\/code>, <code>fr<\/code>, <code>de<\/code>)<br><code>{n}<\/code> = page number<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Managing Rules from the Admin Panel<\/h2>\n\n\n\n<p>The extension provides three tools in the <strong>Settings tab \u2192 .htaccess Rules Configuration<\/strong> section:<\/p>\n\n\n\n<p><strong>Add Code to .htaccess File<\/strong> Reads your current <code>.htaccess<\/code>, removes any existing HB SEO rules, then inserts the latest rules in the correct position. A backup is automatically saved as <code>.htaccess.sitemap.BACKUP<\/code> before any write.<\/p>\n\n\n\n<p><strong>Remove .htaccess Rules<\/strong> Removes only the lines added by this extension. Your other <code>.htaccess<\/code> content is untouched. Reports how many lines were removed.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Manual .htaccess Setup<\/h2>\n\n\n\n<p>If your server does not allow PHP to write to <code>.htaccess<\/code>, copy the code block displayed in the admin panel and paste it into your root <code>.htaccess<\/code> file manually.<\/p>\n\n\n\n<p><strong>Where to place the rules:<\/strong> Place them after the OpenCart <code>system\/storage<\/code> protection <code>RewriteRule<\/code> lines, but <strong>before<\/strong> the main OpenCart catch-all rule:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>RewriteRule ^(&#91;^?]*) index.php?_route_=$1 &#91;L,QSA]<\/code><\/pre>\n\n\n\n<h2 class=\"wp-block-heading\">Nginx Users<\/h2>\n\n\n\n<p>The extension generates Apache-specific rules. For Nginx, translate each <code>RewriteRule<\/code> into an equivalent <code>location ~ regex<\/code> block with a <code>rewrite<\/code> directive in your server config. Contact your hosting provider for assistance.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Troubleshooting<\/h2>\n\n\n\n<p><strong>404 on sitemap URLs after adding rules:<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Confirm <code>mod_rewrite<\/code> is enabled on your server<\/li>\n\n\n\n<li>Confirm <code>AllowOverride All<\/code> is set for your web root in the Apache virtual host config<\/li>\n\n\n\n<li>Check that the rules were actually written (open <code>.htaccess<\/code> in an FTP client and look for lines containing <code>extension\/hbseo\/<\/code>)<\/li>\n<\/ul>\n\n\n\n<p><strong>500 error after adding rules:<\/strong> Your server may have syntax restrictions. Remove the rules using the admin panel button and add them manually after reviewing the syntax.<\/p>\n","protected":false},"featured_media":0,"parent":245,"menu_order":2,"comment_status":"closed","ping_status":"closed","template":"","doc_tag":[],"class_list":["post-14702","docs","type-docs","status-publish","hentry"],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v27.3 - https:\/\/yoast.com\/product\/yoast-seo-wordpress\/ -->\n<title>.htaccess Configuration - HuntBee Resources<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/www.huntbee.com\/resources\/docs\/seo-xml-sitemap-generator-pro\/htaccess-configuration\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\".htaccess Configuration - HuntBee Resources\" \/>\n<meta property=\"og:description\" content=\"The .htaccess configuration gives your sitemaps and AI feeds clean, SEO-friendly URLs. Without these rules, sitemaps are still accessible via full OpenCart route URLs, but clean URLs are preferable for search console submissions and readability. URL Mapping Reference These are the rules the extension adds to your .htaccess: Clean URL Purpose \/sitemap_index.xml Master sitemap index [&hellip;]\" \/>\n<meta property=\"og:url\" content=\"https:\/\/www.huntbee.com\/resources\/docs\/seo-xml-sitemap-generator-pro\/htaccess-configuration\/\" \/>\n<meta property=\"og:site_name\" content=\"HuntBee Resources\" \/>\n<meta property=\"article:publisher\" content=\"https:\/\/www.facebook.com\/huntbee.opencart\" \/>\n<meta property=\"article:modified_time\" content=\"2026-03-02T08:03:05+00:00\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"2 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/www.huntbee.com\\\/resources\\\/docs\\\/seo-xml-sitemap-generator-pro\\\/htaccess-configuration\\\/\",\"url\":\"https:\\\/\\\/www.huntbee.com\\\/resources\\\/docs\\\/seo-xml-sitemap-generator-pro\\\/htaccess-configuration\\\/\",\"name\":\".htaccess Configuration - HuntBee Resources\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/www.huntbee.com\\\/resources\\\/#website\"},\"datePublished\":\"2026-02-19T16:40:25+00:00\",\"dateModified\":\"2026-03-02T08:03:05+00:00\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/www.huntbee.com\\\/resources\\\/docs\\\/seo-xml-sitemap-generator-pro\\\/htaccess-configuration\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/www.huntbee.com\\\/resources\\\/docs\\\/seo-xml-sitemap-generator-pro\\\/htaccess-configuration\\\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/www.huntbee.com\\\/resources\\\/docs\\\/seo-xml-sitemap-generator-pro\\\/htaccess-configuration\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/www.huntbee.com\\\/resources\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"XML Sitemap Generator + AI Feed JSON + IndexNow PRO\",\"item\":\"https:\\\/\\\/www.huntbee.com\\\/resources\\\/docs\\\/seo-xml-sitemap-generator-pro\\\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\".htaccess Configuration\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/www.huntbee.com\\\/resources\\\/#website\",\"url\":\"https:\\\/\\\/www.huntbee.com\\\/resources\\\/\",\"name\":\"HuntBee Resources\",\"description\":\"OpenCart Extension Documentations - Guides - Blogs - Projects\",\"publisher\":{\"@id\":\"https:\\\/\\\/www.huntbee.com\\\/resources\\\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/www.huntbee.com\\\/resources\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"},{\"@type\":\"Organization\",\"@id\":\"https:\\\/\\\/www.huntbee.com\\\/resources\\\/#organization\",\"name\":\"HuntBee OpenCart\",\"url\":\"https:\\\/\\\/www.huntbee.com\\\/resources\\\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/www.huntbee.com\\\/resources\\\/#\\\/schema\\\/logo\\\/image\\\/\",\"url\":\"https:\\\/\\\/www.huntbee.com\\\/resources\\\/wp-content\\\/uploads\\\/2020\\\/04\\\/cropped-mobile-logo-new.png\",\"contentUrl\":\"https:\\\/\\\/www.huntbee.com\\\/resources\\\/wp-content\\\/uploads\\\/2020\\\/04\\\/cropped-mobile-logo-new.png\",\"width\":945,\"height\":200,\"caption\":\"HuntBee OpenCart\"},\"image\":{\"@id\":\"https:\\\/\\\/www.huntbee.com\\\/resources\\\/#\\\/schema\\\/logo\\\/image\\\/\"},\"sameAs\":[\"https:\\\/\\\/www.facebook.com\\\/huntbee.opencart\",\"https:\\\/\\\/www.instagram.com\\\/opencart.huntbee\\\/\"]}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":".htaccess Configuration - HuntBee Resources","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/www.huntbee.com\/resources\/docs\/seo-xml-sitemap-generator-pro\/htaccess-configuration\/","og_locale":"en_US","og_type":"article","og_title":".htaccess Configuration - HuntBee Resources","og_description":"The .htaccess configuration gives your sitemaps and AI feeds clean, SEO-friendly URLs. Without these rules, sitemaps are still accessible via full OpenCart route URLs, but clean URLs are preferable for search console submissions and readability. URL Mapping Reference These are the rules the extension adds to your .htaccess: Clean URL Purpose \/sitemap_index.xml Master sitemap index [&hellip;]","og_url":"https:\/\/www.huntbee.com\/resources\/docs\/seo-xml-sitemap-generator-pro\/htaccess-configuration\/","og_site_name":"HuntBee Resources","article_publisher":"https:\/\/www.facebook.com\/huntbee.opencart","article_modified_time":"2026-03-02T08:03:05+00:00","twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"2 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/www.huntbee.com\/resources\/docs\/seo-xml-sitemap-generator-pro\/htaccess-configuration\/","url":"https:\/\/www.huntbee.com\/resources\/docs\/seo-xml-sitemap-generator-pro\/htaccess-configuration\/","name":".htaccess Configuration - HuntBee Resources","isPartOf":{"@id":"https:\/\/www.huntbee.com\/resources\/#website"},"datePublished":"2026-02-19T16:40:25+00:00","dateModified":"2026-03-02T08:03:05+00:00","breadcrumb":{"@id":"https:\/\/www.huntbee.com\/resources\/docs\/seo-xml-sitemap-generator-pro\/htaccess-configuration\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/www.huntbee.com\/resources\/docs\/seo-xml-sitemap-generator-pro\/htaccess-configuration\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/www.huntbee.com\/resources\/docs\/seo-xml-sitemap-generator-pro\/htaccess-configuration\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/www.huntbee.com\/resources\/"},{"@type":"ListItem","position":2,"name":"XML Sitemap Generator + AI Feed JSON + IndexNow PRO","item":"https:\/\/www.huntbee.com\/resources\/docs\/seo-xml-sitemap-generator-pro\/"},{"@type":"ListItem","position":3,"name":".htaccess Configuration"}]},{"@type":"WebSite","@id":"https:\/\/www.huntbee.com\/resources\/#website","url":"https:\/\/www.huntbee.com\/resources\/","name":"HuntBee Resources","description":"OpenCart Extension Documentations - Guides - Blogs - Projects","publisher":{"@id":"https:\/\/www.huntbee.com\/resources\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/www.huntbee.com\/resources\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Organization","@id":"https:\/\/www.huntbee.com\/resources\/#organization","name":"HuntBee OpenCart","url":"https:\/\/www.huntbee.com\/resources\/","logo":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/www.huntbee.com\/resources\/#\/schema\/logo\/image\/","url":"https:\/\/www.huntbee.com\/resources\/wp-content\/uploads\/2020\/04\/cropped-mobile-logo-new.png","contentUrl":"https:\/\/www.huntbee.com\/resources\/wp-content\/uploads\/2020\/04\/cropped-mobile-logo-new.png","width":945,"height":200,"caption":"HuntBee OpenCart"},"image":{"@id":"https:\/\/www.huntbee.com\/resources\/#\/schema\/logo\/image\/"},"sameAs":["https:\/\/www.facebook.com\/huntbee.opencart","https:\/\/www.instagram.com\/opencart.huntbee\/"]}]}},"comment_count":0,"_links":{"self":[{"href":"https:\/\/www.huntbee.com\/resources\/wp-json\/wp\/v2\/docs\/14702","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.huntbee.com\/resources\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/www.huntbee.com\/resources\/wp-json\/wp\/v2\/types\/docs"}],"replies":[{"embeddable":true,"href":"https:\/\/www.huntbee.com\/resources\/wp-json\/wp\/v2\/comments?post=14702"}],"version-history":[{"count":3,"href":"https:\/\/www.huntbee.com\/resources\/wp-json\/wp\/v2\/docs\/14702\/revisions"}],"predecessor-version":[{"id":14711,"href":"https:\/\/www.huntbee.com\/resources\/wp-json\/wp\/v2\/docs\/14702\/revisions\/14711"}],"up":[{"embeddable":true,"href":"https:\/\/www.huntbee.com\/resources\/wp-json\/wp\/v2\/docs\/245"}],"next":[{"title":"Sitemap Settings","link":"https:\/\/www.huntbee.com\/resources\/docs\/seo-xml-sitemap-generator-pro\/sitemap-settings\/","href":"https:\/\/www.huntbee.com\/resources\/wp-json\/wp\/v2\/docs\/14712"}],"prev":[{"title":"Installation","link":"https:\/\/www.huntbee.com\/resources\/docs\/seo-xml-sitemap-generator-pro\/installation\/","href":"https:\/\/www.huntbee.com\/resources\/wp-json\/wp\/v2\/docs\/344"}],"wp:attachment":[{"href":"https:\/\/www.huntbee.com\/resources\/wp-json\/wp\/v2\/media?parent=14702"}],"wp:term":[{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/www.huntbee.com\/resources\/wp-json\/wp\/v2\/doc_tag?post=14702"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}