Add docs for item templates in SQL Database Projects (VS Code)

Author: rwestMSFT

docs/toc.yml

@@ -8999,6 +8999,8 @@ items:
         href: tools/visual-studio-code-extensions/sql-database-projects/getting-started-sql-database-projects-extension.md
       - name: Build from the Command Line
         href: tools/visual-studio-code-extensions/sql-database-projects/build-database-project-from-command-line.md
+      - name: Add database objects using item templates
+        href: tools/visual-studio-code-extensions/sql-database-projects/add-item-templates.md
       - name: Publish database project
         href: tools/visual-studio-code-extensions/sql-database-projects/publish-database-project.md
 - name: Tutorials

docs/tools/visual-studio-code-extensions/sql-database-projects/add-item-templates.md

@@ -0,0 +1,83 @@
+---
+title: Add Database Objects Using Item Templates
+description: Use the SQL Database Projects extension for Visual Studio Code to add common database objects to your project using item templates.
+author: rwestMSFT
+ms.author: randolphwest
+ms.reviewer: iqrashaikh
+ms.date: 02/10/2026
+ms.service: sql
+ms.subservice: sql-database-projects
+ms.topic: how-to
+---
+
+# Add database objects using item templates
+
+Use the SQL Database Projects extension for Visual Studio Code to add common database objects to your project using item templates. Item templates generate properly formatted Transact-SQL (T-SQL) files with standard boilerplate code, helping you maintain consistency across your database schema.
+
+Database objects added to a SQL project are validated during the project build. This validation helps you catch syntax and reference problems early, before deployment starts.
+
+## Prerequisites
+
+- Visual Studio Code installed
+- The SQL Database Projects extension
+- An existing SQL database project (`.sqlproj`)
+
+## Available item templates
+
+The SQL Database Projects extension includes the following item templates:
+
+| Template | Description |
+| --- | --- |
+| **Schema** | Creates a new database schema for organizing database objects into logical groups. |
+| **Table-Valued Function** | Creates a function that returns a table result set. |
+| **Sequence** | Creates a sequence object that generates sequential numeric values. |
+| **Trigger** | Creates a DML trigger that runs when `INSERT`, `UPDATE`, or `DELETE` operations occur on a table or view. |
+| **Database Trigger** | Creates a DDL trigger that runs in response to database-level events. |
+
+## Add an item to your project
+
+Add database objects to your project using item templates from the Database Projects view.
+
+1. In the Database Projects view, right-click your SQL project or an included folder.
+
+   > [!NOTE]  
+   > To keep larger projects manageable, many SQL projects organize files by schema and object type. For example, you might use `dbo/Tables` or `sales/Views`.
+
+1. Select **Add Item**.
+
+1. Select the type of object you want to create.
+
+1. Enter a name for the new object.
+
+::: image type="content" source="media/add-item-templates/add-item-menu.png" alt-text="Screenshot of context menu showing Add Item option." lightbox="media/add-item-templates/add-item-menu.png":::
+
+The extension creates a T-SQL file in your project with template code for the selected object type.
+
+> [!NOTE]  
+> You can also add items using the Command Palette. Press **Ctrl**+**Shift**+**P** (Windows/Linux) or **Cmd**+**Shift**+**P** (macOS), and then type **SQL Database Projects: Add Item**.
+
+## Template examples
+
+These examples show the T-SQL code generated by item templates.
+
+### Schema
+
+The schema template creates a file with a `CREATE SCHEMA` statement:
+
+:::image type="content" source="media/add-item-templates/schema-template.png" alt-text="Screenshot of generated schema file." lightbox="media/add-item-templates/schema-template.png":::
+
+### Table-valued function
+
+The table-valued function template includes parameter and return table placeholders:
+
+:::image type="content" source="media/add-item-templates/table-valued-function-template.png" alt-text="Screenshot of generated table-valued function." lightbox="media/add-item-templates/table-valued-function-template.png":::
+
+Modify the parameter names, data types, and return table columns to match your requirements.
+
+## Related content
+
+- [Publish SQL database projects from Visual Studio Code](publish-database-project.md)
+- [Get started with the SQL Database Projects extension](getting-started-sql-database-projects-extension.md)
+- [What are SQL database projects?](../../sql-database-projects/sql-database-projects.md)
+- [CREATE SCHEMA (Transact-SQL)](../../../t-sql/statements/create-schema-transact-sql.md)
+- [CREATE FUNCTION (Transact-SQL)](../../../t-sql/statements/create-function-transact-sql.md)