SeverAnna · Nov 2, 2026 · Nov 2, 2026
diff --git a/docs/adguard-vpn-browser-extension/_category_.json b/docs/adguard-vpn-browser-extension/_category_.json
@@ -1,5 +1,5 @@
 {
-"position": 6,
+"position": 8,
 "label": "AdGuard VPN browser extensions",
 "collapsible": true,
 "collapsed": true

diff --git a/docs/adguard-vpn-for-android/_category_.json b/docs/adguard-vpn-for-android/_category_.json
@@ -1,5 +1,5 @@
 {
-"position": 3,
+"position": 5,
 "label": "AdGuard VPN for Android",
 "collapsible": true,
 "collapsed": true

diff --git a/docs/adguard-vpn-for-ios/_category_.json b/docs/adguard-vpn-for-ios/_category_.json
@@ -1,5 +1,5 @@
 {
-    "position": 4,
+    "position": 6,
     "label": "AdGuard VPN for iOS",
     "collapsible": true,
     "collapsed": true

diff --git a/docs/adguard-vpn-for-linux/_category_.json b/docs/adguard-vpn-for-linux/_category_.json
@@ -1,5 +1,5 @@
 {
-    "position": 7,
+    "position": 9,
     "label": "AdGuard VPN for Linux",
     "collapsible": true,
     "collapsed": true

diff --git a/docs/adguard-vpn-for-mac/_category_.json b/docs/adguard-vpn-for-mac/_category_.json
@@ -1,5 +1,5 @@
 {
-    "position": 5,
+    "position": 7,
     "label": "AdGuard VPN for Mac",
     "collapsible": true,
     "collapsed": true

diff --git a/docs/adguard-vpn-for-routers/_category_.json b/docs/adguard-vpn-for-routers/_category_.json
@@ -1,5 +1,5 @@
 {
-    "position": 8,
+    "position": 10,
     "label": "AdGuard VPN for routers",
     "collapsible": true,
     "collapsed": true

diff --git a/docs/adguard-vpn-for-windows/_category_.json b/docs/adguard-vpn-for-windows/_category_.json
@@ -1,5 +1,5 @@
 {
-    "position": 4,
+    "position": 6,
     "label": "AdGuard VPN for Windows",
     "collapsible": true,
     "collapsed": true

diff --git a/docs/common-questions/_category_.json b/docs/common-questions/_category_.json
@@ -0,0 +1,6 @@
+{
+    "position": 4,
+    "label": "Common questions",
+    "collapsible": true,
+    "collapsed": true
+}
diff --git a/docs/general/dns-leaks.md → docs/common-questions/dns-leaks.md b/docs/general/dns-leaks.md → docs/common-questions/dns-leaks.md
@@ -1,6 +1,7 @@
 ---
 title: What is a DNS leak
-sidebar_position: 9
+sidebar_position: 4
+slug: /general/dns-leaks
 ---
 
 Once you install a VPN, you want to be sure that there won’t be any leaks that will lead to your de-anonymization. AdGuard VPN reliably protects your traffic and your data from prying eyes. Nevertheless, in some cases you may suspect the presence of DNS leaks in our VPN service. We’ll explain where these concerns come from and why they are unfounded.

diff --git a/docs/general/older_os.md → docs/common-questions/older_os.md b/docs/general/older_os.md → docs/common-questions/older_os.md
@@ -1,6 +1,7 @@
 ---
 title: Installing AdGuard VPN on older OS versions
-sidebar_position: 14
+sidebar_position: 2
+slug: /general/older_os
 ---
 
 If your device runs an older operating system, you may not be able to install the latest version of AdGuard VPN. If this is the case, you can download an earlier, compatible version of the app using the links below.

diff --git a/...eneral/selective-mode-filtering-issues.md → ...stions/selective-mode-filtering-issues.md b/...eneral/selective-mode-filtering-issues.md → ...stions/selective-mode-filtering-issues.md
@@ -1,6 +1,7 @@
 ---
 title: WhatsApp and Discord traffic filtering specifics
-sidebar_position: 12
+sidebar_position: 3
+slug: /general/selective-mode-filtering-issues
 ---
 
 When AdGuard VPN is active *selectively*, it only filters website and app traffic from the exclusions lists. All other traffic bypasses the VPN tunnel. This mechanism works reliably only if the system can clearly identify which network connections belong to a specific app.

diff --git a/docs/general/vpn-issues.md → docs/common-questions/vpn-issues.md b/docs/general/vpn-issues.md → docs/common-questions/vpn-issues.md
@@ -1,6 +1,7 @@
 ---
 title: How to use AdGuard VPN in countries with Internet restrictions
-sidebar_position: 10
+sidebar_position: 1
+slug: /general/vpn-issues
 ---
 
 In certain regions, such as China, Iran, and Russia, users might experience problems connecting to AdGuard VPN. Here are the options that might help.

diff --git a/docs/general/adguard-vpn-encryption.md b/docs/general/adguard-vpn-encryption.md
@@ -1,6 +1,6 @@
 ---
 title: What type of encryption is used in AdGuard VPN
-sidebar_position: 7
+sidebar_position: 3
 ---
 
 ## Introduction

diff --git a/docs/general/how-vpn-works.md b/docs/general/how-vpn-works.md
@@ -85,6 +85,6 @@ Currently, AdGuard VPN is available as:
 
 - Command-line interface for [Linux, Mac, and some routers](/adguard-vpn-for-linux/)
 
-- A VPN client for [routers](/general/set-up-adguard-vpn-on-your-router/)
+- A VPN client for [routers](/adguard-vpn-for-routers/installation/)
 
 [Learn more about AdGuard VPN features](https://adguard-vpn.com/welcome.html)
diff --git a/docs/general/vpn-modes-exclusions.md b/docs/general/vpn-modes-exclusions.md
@@ -1,6 +1,6 @@
 ---
 title: VPN modes and Exclusion lists
-sidebar_position: 11
+sidebar_position: 4
 ---
 
 This section explains how to use website and app exclusions in different VPN modes.

diff --git a/docs/miscellaneous/_category_.json b/docs/miscellaneous/_category_.json
@@ -1,5 +1,5 @@
 {
-    "position": 9,
+    "position": 11,
     "label": "Miscellaneous",
     "collapsible": true,
     "collapsed": true

diff --git a/docs/general/how-to-install.md → docs/miscellaneous/legacy-how-to-install.md b/docs/general/how-to-install.md → docs/miscellaneous/legacy-how-to-install.md
@@ -1,6 +1,8 @@
 ---
 title: How to install AdGuard VPN
 sidebar_position: 3
+unlisted: true
+slug: /general/how-to-install
 ---
 
 Depending on which AdGuard VPN app or browser extension you want to install, follow one of these links to find the relevant article:
@@ -10,5 +12,5 @@ Depending on which AdGuard VPN app or browser extension you want to install, fol
 - [AdGuard VPN for Windows](/adguard-vpn-for-windows/installation)
 - [AdGuard VPN for Mac](/adguard-vpn-for-mac/installation)
 - [AdGuard VPN Browser Extension](/adguard-vpn-browser-extension/installation)
-- [AdGuard VPN for routers](/general/set-up-adguard-vpn-on-your-router/)
+- [AdGuard VPN for routers](/adguard-vpn-for-routers/installation/)
 - [AdGuard VPN for Linux](/adguard-vpn-for-linux/installation)
diff --git a/...eral/set-up-adguard-vpn-on-your-router.md → ...gacy-set-up-adguard-vpn-on-your-router.md b/...eral/set-up-adguard-vpn-on-your-router.md → ...gacy-set-up-adguard-vpn-on-your-router.md
@@ -1,6 +1,8 @@
 ---
 title: How to set up AdGuard VPN on your router
 sidebar_position: 8
+unlisted: true
+slug: /general/set-up-adguard-vpn-on-your-router
 ---
 
 Setting up AdGuard VPN on your router allows you to protect all devices connected to your network. This includes smart TVs, media players, gaming consoles, and other gadgets that do not support VPN apps directly.

diff --git a/docs/subscription/_category_.json b/docs/subscription/_category_.json
@@ -0,0 +1,6 @@
+{
+    "position": 3,
+    "label": "Subscription",
+    "collapsible": true,
+    "collapsed": true
+}
diff --git a/docs/general/activate-subscription.md → docs/subscription/activate-subscription.md b/docs/general/activate-subscription.md → docs/subscription/activate-subscription.md
@@ -1,6 +1,7 @@
 ---
 title: Activate AdGuard VPN subscription
-sidebar_position: 13
+sidebar_position: 3
+slug: /general/activate-subscription
 ---
 
 To activate your AdGuard VPN subscription, follow these steps:

diff --git a/docs/general/free-vs-unlimited.md → docs/subscription/free-vs-unlimited.md b/docs/general/free-vs-unlimited.md → docs/subscription/free-vs-unlimited.md
@@ -1,6 +1,7 @@
 ---
 title: Benefits of AdGuard VPN Unlimited
-sidebar_position: 5
+sidebar_position: 1
+slug: /general/free-vs-unlimited
 ---
 
 You can use AdGuard VPN for free, but then there will be certain restrictions:

diff --git a/docs/general/subscription.md → docs/subscription/how-to-subscribe.md b/docs/general/subscription.md → docs/subscription/how-to-subscribe.md
@@ -1,6 +1,7 @@
 ---
 title: How to subscribe
-sidebar_position: 6
+sidebar_position: 2
+slug: /general/subscription
 ---
 
 AdGuard VPN is available in two versions — a free and a paid one. The subscription allows you to use the app without any restrictions on traffic, connection speed and the choice of locations. [Read more about all the advantages of AdGuard VPN Unlimited](/general/free-vs-unlimited).