CONCAT_WS()

This function returns a string resulting from the concatenation, or joining, of two or more string values in an end-to-end manner, using a string separator.

Signature

CONCAT_WS ( separator , argument1 , argument2 [ , argumentN ] ... )

Parameters

separator — An expression of any character type (char, nchar, nvarchar, or varchar).

Examples

SELECT CONCAT_WS(', ', 'north', NULL, 'south') AS joined;

joined
--------------
north, south

SELECT CONCAT_WS(' - ', database_id, recovery_model_desc, containment_desc) AS DatabaseInfo
FROM sys.databases;

1 - SIMPLE - NONE
2 - SIMPLE - NONE
3 - FULL - NONE
4 - SIMPLE - NONE
5 - FULL - NONE
6 - FULL - NONE
7 - FULL - NONE

SELECT CONCAT_WS(',', '1 Microsoft Way', NULL, NULL, 'Redmond', 'WA', 98052) AS Address;

1 Microsoft Way,Redmond,WA,98052

Run against SQL Server 16.0.4265.3 on 2026-09-13. This is the output we got, not the documentation’s.

Available on

SQL Server 2017 and later
Azure SQL Database
Azure SQL Managed Instance
Azure Synapse Analytics
Microsoft Fabric warehouse
Fabric SQL database

Signature and description adapted from the Microsoft SQL documentation, used under the CC BY 4.0. SQL Server and Azure are trademarks of the Microsoft group of companies. This page is not affiliated with Microsoft.