Merged main into live

mijacobs · mijacobs · commit 4df1f165f19c · 2025-08-11T01:02:33.000Z
diff --git a/.openpublishing.redirection.json b/.openpublishing.redirection.json
@@ -1,5 +1,10 @@
 {
   "redirections": [
+    {
+      "source_path": "docs/ide/reference/options-text-editor-all-languages-tabs.md",
+      "redirect_url": "/visualstudio/ide/options-text-editor-all-languages-tabs",
+      "redirect_document_id": false
+    },
     {
       "source_path": "docs/ide/reference/paste-json-xml.md",
       "redirect_url": "/visualstudio/ide/paste-json-xml",
diff --git a/docs/ide/options-text-editor-all-languages-tabs.md b/docs/ide/options-text-editor-all-languages-tabs.md
@@ -0,0 +1,94 @@
+---
+title: Configure indent and tab settings
+description: Learn how to use the Tabs page in the All Languages section to change the default behavior of the code editor tabs within Visual Studio.
+ms.date: 08/08/2025
+ms.topic: reference
+f1_keywords:
+- VS.ToolsOptionsPages.Text_Editor.All_Languages.Tabs
+- VS.ToolsOptionsPages.Text_Editor.Basic.Tabs
+- VS.ToolsOptionsPages.Text_Editor.CSharp.Tabs
+- VS.ToolsOptionsPages.Text_Editor.C%2FC%2B%2B.Tabs
+- VS.ToolsOptionsPages.Text_Editor.CoffeeScript.Tabs
+- VS.ToolsOptionsPages.Text_Editor.CSS.Tabs
+- VS.ToolsOptionsPages.Text_Editor.Dockerfile.Tabs
+- VS.ToolsOptionsPages.Text_Editor.F%2523.Tabs
+- VS.ToolsOptionsPages.Text_Editor.HQL.Tabs
+- VS.ToolsOptionsPages.Text_Editor.HTML.Tabs
+- VS.ToolsOptionsPages.Text_Editor.HTMLX.Tabs
+- VS.ToolsOptionsPages.Text_Editor.JavaScript.Tabs
+- VS.ToolsOptionsPages.Text_Editor.TypeScript.Tabs
+- VS.ToolsOptionsPages.Text_Editor.JSON.Tabs
+- VS.ToolsOptionsPages.Text_Editor.LESS.Tabs
+- VS.ToolsOptionsPages.Text_Editor.Plain_Text.Tabs
+- VS.ToolsOptionsPages.Text_Editor.ResJSON.Tabs
+- VS.ToolsOptionsPages.Text_Editor.SCSS.Tabs
+- VS.ToolsOptionsPages.Text_Editor.SQL_Server_Tools.Tabs
+- VS.ToolsOptionsPages.Text_Editor.StreamAnalytics.Tabs
+- VS.ToolsOptionsPages.Text_Editor.T-SQL90.Tabs
+- VS.ToolsOptionsPages.Text_Editor.U-SQL.Tabs
+- VS.ToolsOptionsPages.Text_Editor.XAML.Tabs
+- VS.ToolsOptionsPages.Text_Editor.XML.Tabs
+helpviewer_keywords:
+- indents, Code Editor
+- Code Editor, default behavior
+- tabs, setting in Code Editor
+- All Languages Text Editor Options dialog box
+- editors, Code Editor
+- Code Editor, indenting
+- Code Editor, tabs
+ms.custom: "ide-ref"
+author: anandmeg
+ms.author: meghaanand
+manager: mijacobs
+ms.subservice: general-ide
+---
+# Configure indent and tab settings in Visual Studio
+
+Learn how to change the default tab and indentation behavior for the Code Editor in Visual Studio using the text editor configuration options.
+
+## Access the All Languages Tabs options
+
+1. Open Visual Studio.
+2. On the menu bar, select **Tools** > **Options**.
+3. In the Options dialog, expand the **Text Editor** node.
+4. Expand **All Languages**, then select **Tabs**.
+
+> [!CAUTION]
+> Changes made here apply to all development languages. Resetting options in this dialog will override individual language settings. To configure options for a specific language, select its subfolder under **Text Editor**.
+
+## Resolve conflicting settings
+
+If you select different tab or indent settings for individual languages, Visual Studio displays a warning message:
+- "The indentation settings for individual text formats conflict with each other," for differing **Indenting** options.
+- "The tab settings for individual text formats conflict with each other," for differing **Tab** options.
+
+For example, if **Smart indenting** is set for Visual Basic and **Block indenting** for Visual C++, you’ll see a reminder about the conflict.
+
+## Configure indenting options
+
+In the **Indenting** section, choose one of the following indenting styles:
+
+- **None**: New lines are not indented; the cursor starts at the first column.
+- **Block**: New lines are automatically indented to match the previous line.
+- **Smart**: New lines are indented based on code context and IntelliSense conventions. Not available for all languages.
+
+For example, lines between braces `{ }` may be indented an extra tab stop.
+
+## Configure tab options
+
+In the **Tabs** section, choose the following options.
+
+- **Tab size**: Sets the number of spaces per tab stop (default: 4).
+- **Indent size**: Sets the number of spaces for each indentation (default: 4). Tabs, spaces, or both are used to fill the size.
+- **Insert spaces**: Indent operations insert only space characters.
+- **Keep tabs**: Indent operations insert as many tab characters as possible; spaces fill any remainder.
+
+## Troubleshooting
+
+> [!TIP]
+> Adaptive formatting may override your custom tab settings. To disable adaptive formatting, go to **Text Editor** > **Advanced** and toggle **Use adaptive formatting**. You can also use an [.editorconfig](../ide/create-portable-custom-editor-options.md) file to manage indent styles.
+
+## Next steps
+
+- [Options, Text Editor, All Languages](../ide/reference/options-text-editor-all-languages.md)
+- [General, Environment, Options Dialog Box](../ide/reference/general-environment-options-dialog-box.md)
diff --git a/docs/ide/productivity-features.md b/docs/ide/productivity-features.md
@@ -74,7 +74,7 @@ Write code more quickly by using the following features.
 
 - **Change brace formatting with Formatting/New Lines**. Use the **Formatting**  options page to set options  for formatting code in the code editor, including new lines. For more information on how to use this setting in C#, see [Options dialog box: Text Editor > C# > Code Style > Formatting](../ide/reference/options-text-editor-csharp-formatting.md). For C++, see [Set your C++ coding preferences in Visual Studio](/cpp/ide/how-to-set-preferences). For Python, see [Format Python code](../python/formatting-python-code.md).
 
-- **Change your indentation with Tabs**. Use custom editor settings, tailored to each codebase, to enforce consistent coding styles for multiple developers working on the same project across different editors and IDEs. Ensure your whole team follows the same language conventions, naming conventions, and formatting rules. Since these custom settings are portable and travel with your code, you can enforce coding styles even outside of Visual Studio. For more information, see [Options, Text Editor, All Languages, Tabs](../ide/reference/options-text-editor-all-languages-tabs.md#tabs).
+- **Change your indentation with Tabs**. Use custom editor settings, tailored to each codebase, to enforce consistent coding styles for multiple developers working on the same project across different editors and IDEs. Ensure your whole team follows the same language conventions, naming conventions, and formatting rules. Since these custom settings are portable and travel with your code, you can enforce coding styles even outside of Visual Studio. For more information, see [Options, Text Editor, All Languages, Tabs](../ide/options-text-editor-all-languages-tabs.md).
 
 ::: moniker range=">=vs-2022" 
 - [**Try automatic copy and trim indentation**](writing-code-in-the-code-and-text-editor.md#copy-and-paste-code). Copy code from Visual Studio to another program (Outlook, Teams, etc.), without having to manually fix indentation after you paste your code. Available in Visual Studio 2022 [version 17.7](/visualstudio/releases/2022/release-notes) and later.
diff --git a/docs/ide/reference/options-text-editor-advanced.md b/docs/ide/reference/options-text-editor-advanced.md
@@ -92,7 +92,7 @@ Select this option to disable the new [multi-caret selection](../finding-and-rep
 
 ## Use adaptive formatting
 
-Based on your most recently updated file, Visual Studio recognizes whether you prefer to use tabs or spaces to indent code. The adaptive formatting option is selected by default. When unselected, Visual Studio uses the settings in **Tools** > **Options** > **Text Editor** > **All Languages** > **[Tabs](options-text-editor-all-languages-tabs.md)** instead.
+Based on your most recently updated file, Visual Studio recognizes whether you prefer to use tabs or spaces to indent code. The adaptive formatting option is selected by default. When unselected, Visual Studio uses the settings in **Tools** > **Options** > **Text Editor** > **All Languages** > **[Tabs](../options-text-editor-all-languages-tabs.md)** instead.
 
 > [!TIP]
 > You can also change how Visual Studio manages your preferred indent style by using an .*editorconfig* file. For more information, see [Create portable, custom editor settings with EditorConfig](../create-portable-custom-editor-options.md).
@@ -134,7 +134,7 @@ Select this option if you prefer to set the maximum latency that Visual Studio a
 
 ## Use adaptive formatting
 
-Based on your most recently updated file, Visual Studio recognizes whether you prefer to use tabs or spaces for code indentation. The adaptive formatting option is selected by default. When unselected, Visual Studio uses the settings in **Tools** > **Options** > **Text Editor** > **All Languages** > **[Tabs](options-text-editor-all-languages-tabs.md)** instead.
+Based on your most recently updated file, Visual Studio recognizes whether you prefer to use tabs or spaces for code indentation. The adaptive formatting option is selected by default. When unselected, Visual Studio uses the settings in **Tools** > **Options** > **Text Editor** > **All Languages** > **[Tabs](../options-text-editor-all-languages-tabs.md)** instead.
 
 ::: moniker-end
 
diff --git a/docs/ide/reference/options-text-editor-all-languages-tabs.md b/docs/ide/reference/options-text-editor-all-languages-tabs.md
diff --git a/docs/ide/reference/options-text-editor-all-languages.md b/docs/ide/reference/options-text-editor-all-languages.md
@@ -125,6 +125,6 @@ This setting has no effect on Copy or Cut when a line isn't blank. If nothing is
 
 ## See also
 
-- [Options, Text Editor, All Languages, Tabs](../../ide/reference/options-text-editor-all-languages-tabs.md)
+- [Options, Text Editor, All Languages, Tabs](../../ide/options-text-editor-all-languages-tabs.md)
 - [General, Environment, Options Dialog Box](../../ide/reference/general-environment-options-dialog-box.md)
 - [Using IntelliSense](../../ide/using-intellisense.md)
diff --git a/docs/ide/reference/options-text-editor-basic-visual-basic.md b/docs/ide/reference/options-text-editor-basic-visual-basic.md
@@ -140,4 +140,4 @@ The text editor can suggest solutions to common errors and allow you to select t
 ## See also
 
 - [General, Environment, Options Dialog Box](../../ide/reference/general-environment-options-dialog-box.md)
-- [Options, Text Editor, All Languages, Tabs](../../ide/reference/options-text-editor-all-languages-tabs.md)
+- [Options, Text Editor, All Languages, Tabs](../../ide/options-text-editor-all-languages-tabs.md)
diff --git a/docs/ide/reference/options-text-editor-fsharp-advanced.md b/docs/ide/reference/options-text-editor-fsharp-advanced.md
@@ -26,4 +26,4 @@ Select this check box to automatically outline the code file, which creates coll
 ## See also
 
 - [General, Environment, Options Dialog Box](../../ide/reference/general-environment-options-dialog-box.md)
-- [Options, Text Editor, All Languages, Tabs](../../ide/reference/options-text-editor-all-languages-tabs.md)
+- [Options, Text Editor, All Languages, Tabs](../../ide/options-text-editor-all-languages-tabs.md)
diff --git a/docs/ide/reference/options-text-editor-general.md b/docs/ide/reference/options-text-editor-general.md
@@ -266,7 +266,7 @@ Use this control to toggle the editing context settings altogether, or personali
 ## See also
 
 - [Options, Text Editor, All Languages](../../ide/reference/options-text-editor-all-languages.md)
-- [Options, Text Editor, All Languages, Tabs](../../ide/reference/options-text-editor-all-languages-tabs.md)
+- [Options, Text Editor, All Languages, Tabs](../../ide/options-text-editor-all-languages-tabs.md)
 - [Options, Text Editor, File Extension](/previous-versions/visualstudio/visual-studio-2017/ide/reference/options-text-editor-file-extension)
 - [Identifying and Customizing Keyboard Shortcuts](../../ide/identifying-and-customizing-keyboard-shortcuts-in-visual-studio.md)
 - [Customizing the Editor](../how-to-change-text-case-in-the-editor.md)
diff --git a/docs/toc.yml b/docs/toc.yml
@@ -543,6 +543,8 @@
         href: ide/reference/how-to-display-line-numbers-in-the-editor.md
       - name: Display URLs as links
         href: ide/reference/how-to-display-urls-as-links-in-the-editor.md
+      - name: Change indents and tabs
+        href: ide/reference/options-text-editor-all-languages-tabs.md
     - name: Code style
       items:
       - name: Code style preferences
@@ -952,8 +954,6 @@
           items:
           - name: General
             href: ide/reference/options-text-editor-all-languages.md
-          - name: Tabs
-            href: ide/reference/options-text-editor-all-languages-tabs.md
         - name: Visual Basic
           items:
           - name: Advanced

Original file line number	Diff line number	Diff line change
`@@ -1,5 +1,10 @@`
`1`	`1`	`{`
`2`	`2`	`"redirections": [`
	`3`	`+ {`
	`4`	`+ "source_path": "docs/ide/reference/options-text-editor-all-languages-tabs.md",`
	`5`	`+ "redirect_url": "/visualstudio/ide/options-text-editor-all-languages-tabs",`
	`6`	`+ "redirect_document_id": false`
	`7`	`+ },`
`3`	`8`	`{`
`4`	`9`	`"source_path": "docs/ide/reference/paste-json-xml.md",`
`5`	`10`	`"redirect_url": "/visualstudio/ide/paste-json-xml",`