Linter - no unused imports

Author: mumian

articles/azure-resource-manager/bicep/bicep-config-linter.md

@@ -75,6 +75,9 @@ The following example shows the rules that are available for configuration.
         "no-unused-existing-resources": {
           "level": "warning"
         },
+        "no-unused-imports": {
+          "level": "error"
+        },
         "no-unused-params": {
           "level": "warning"
         },

articles/azure-resource-manager/bicep/bicep-core-diagnostics.md

@@ -7,7 +7,7 @@ ms.custom:
   - devx-track-bicep
   - devx-track-arm-template
   - build-2025
-ms.date: 05/20/2025
+ms.date: 06/06/2025
 ---
 
 # Bicep core diagnostics

articles/azure-resource-manager/bicep/linter-rule-no-unused-imports.md

@@ -0,0 +1,46 @@
+---
+title: Linter rule - no unused imports
+description: Linter rule - no unused imports
+ms.topic: reference
+ms.custom: devx-track-bicep
+ms.date: 06/06/2025
+---
+
+# Linter rule - no unused imports
+
+This rule finds [import alias](./bicep-import.md#import-variables-types-and-functions) that aren't referenced anywhere in the Bicep file.
+
+## Linter rule code
+
+Use the following value in the [Bicep configuration file](bicep-config-linter.md) to customize rule settings:
+
+`no-unused-imports`
+
+## Solution
+
+To reduce confusion in your Bicep file, delete any imports that are defined but not used. This test finds all imports that aren't used anywhere in the template.
+
+The following example fails this test because `myImports` and `myObjectType` are not used in the Bicep file:
+
+```bicep
+import * as myImports from 'exports.bicep'
+import {myObjectType, sayHello} from 'exports.bicep'
+
+output greeting string = sayHello('Bicep user')
+```
+
+You can fix it by removing and updating the `import` statements.
+
+```bicep
+import {sayHello} from 'exports.bicep'
+
+output greeting string = sayHello('Bicep user')
+```
+
+Use **Quick Fix** to remove the unused imports:
+
+:::image type="content" source="./media/linter-rule-no-unused-imports/linter-rule-no-unused-imports-quick-fix.png" alt-text="A screenshot of using Quick Fix for the no-unused-variables linter rule.":::
+
+## Next steps
+
+For more information about the linter, see [Use Bicep linter](./linter.md).

articles/azure-resource-manager/bicep/linter.md

@@ -3,7 +3,7 @@ title: Use Bicep linter
 description: Learn how to use Bicep linter.
 ms.topic: how-to
 ms.custom: devx-track-bicep
-ms.date: 02/12/2025
+ms.date: 06/06/2025
 ---
 
 # Use Bicep linter
@@ -35,6 +35,7 @@ The default set of linter rules is minimal and taken from [arm-ttk test cases](.
 - [no-loc-expr-outside-params](./linter-rule-no-loc-expr-outside-params.md)
 - [no-unnecessary-dependson](./linter-rule-no-unnecessary-dependson.md)
 - [no-unused-existing-resources](./linter-rule-no-unused-existing-resources.md)
+- [no-unused-imports](./linter-rule-no-unused-imports.md)
 - [no-unused-params](./linter-rule-no-unused-parameters.md)
 - [no-unused-vars](./linter-rule-no-unused-variables.md)
 - [outputs-should-not-contain-secrets](./linter-rule-outputs-should-not-contain-secrets.md)
@@ -57,7 +58,7 @@ The default set of linter rules is minimal and taken from [arm-ttk test cases](.
 - [use-stable-vm-image](./linter-rule-use-stable-vm-image.md)
 - [what-if-short-circuiting](./linter-rule-what-if-short-circuiting.md)
 
-You can customize how the linter rules are applied. To overwrite the default settings, add a **bicepconfig.json** file and apply custom settings. For more information about applying those settings, see [Add custom settings in the Bicep config file](bicep-config-linter.md).
+You can enable or disable all linter rules and control how they are applied using a configuration file. To override the default behavior, create a **bicepconfig.json** file with your custom settings. For more information about applying those settings, see [Add custom settings in the Bicep config file](bicep-config-linter.md).
 
 ## Use in Visual Studio Code