ℹ️ Skipped - page is already crawled
| Filter | Status | Condition | Details |
|---|---|---|---|
| HTTP status | PASS | download_http_code = 200 | HTTP 200 |
| Age cutoff | PASS | download_stamp > now() - 6 MONTH | 0.9 months ago |
| History drop | PASS | isNull(history_drop_reason) | No drop reason |
| Spam/ban | PASS | fh_dont_index != 1 AND ml_spam_score = 0 | ml_spam_score=0 |
| Canonical | PASS | meta_canonical IS NULL OR = '' OR = src_unparsed | Not set |
| Property | Value |
|---|---|
| URL | https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/groupconcat |
| Last Crawled | 2026-03-17 05:48:49 (26 days ago) |
| First Indexed | 2025-02-26 03:42:43 (1 year ago) |
| HTTP Status Code | 200 |
| Meta Title | groupConcat | ClickHouse Docs |
| Meta Description | Calculates a concatenated string from a group of strings, optionally separated by a delimiter, and optionally limited by a maximum number of elements. |
| Meta Canonical | null |
| Boilerpipe Text | groupConcat
Introduced in: v24.8.0
Calculates a concatenated string from a group of strings, optionally separated by a delimiter, and optionally limited by a maximum number of elements.
Note
If delimiter is specified without limit, it must be the first parameter. If both delimiter and limit are specified, delimiter must precede limit.
Also, if different delimiters are specified as parameters and arguments, the delimiter from arguments will be used only.
Syntax
groupConcat[(delimiter [, limit])](expression)
Aliases
:
group_concat
Parameters
delimiter
— A string that will be used to separate concatenated values. This parameter is optional and defaults to an empty string if not specified.
String
limit
— A positive integer specifying the maximum number of elements to concatenate. If more elements are present, excess elements are ignored. This parameter is optional.
UInt*
Arguments
expression
— The expression or column name that outputs strings to be concatenated.
String
delimiter
— A string that will be used to separate concatenated values. This parameter is optional and defaults to an empty string or delimiter from parameters if not specified.
String
Returned value
Returns a string consisting of the concatenated values of the column or expression. If the group has no elements or only null elements, and the function does not specify a handling for only null values, the result is a nullable string with a null value.
String
Examples
Basic usage without a delimiter
SELECT groupConcat(Name) FROM Employees;
JohnJaneBob
Using comma as a delimiter (parameter syntax)
SELECT groupConcat(', ')(Name) FROM Employees;
John, Jane, Bob
Using comma as a delimiter (argument syntax)
SELECT groupConcat(Name, ', ') FROM Employees;
John, Jane, Bob
Limiting the number of concatenated elements
SELECT groupConcat(', ', 2)(Name) FROM Employees;
John, Jane |
| Markdown | [Skip to main content](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/groupconcat#__docusaurus_skipToContent_fallback)
[](https://clickhouse.com/)
- [Products](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/groupconcat)
- [ClickHouse Cloud Best way to use ClickHouse. Available on AWS, GCP, and Azure.](https://clickhouse.com/cloud)
- [BYOC (Bring Your Own Cloud) The fully managed ClickHouse Cloud service, Can be deployed in your AWS account.](https://clickhouse.com/cloud/bring-your-own-cloud)
- [ClickHouse Set up a database with open-source ClickHouse. ClickHouse](https://clickhouse.com/clickhouse)
- [Discover more than 100 integrations.](https://clickhouse.com/integrations)
[Discover more than 100 integrations.](https://clickhouse.com/integrations)
- [Use cases](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/groupconcat)
- [Real-time analytics](https://clickhouse.com/use-cases/real-time-analytics)
- [Machine Learning & Generative AI](https://clickhouse.com/use-cases/machine-learning-and-data-science)
- [Business Intelligence](https://clickhouse.com/use-cases/data-warehousing)
- [Logs, Events, Traces](https://clickhouse.com/use-cases/observability)
- [All use cases](https://clickhouse.com/use-cases)
[All use cases](https://clickhouse.com/use-cases)
- [Documentation](https://clickhouse.com/docs)
- [Resources](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/groupconcat)
- [User stories](https://clickhouse.com/user-stories)
- [Blog](https://clickhouse.com/blog)
- [Events](https://clickhouse.com/company/events)
- [Learning and certification](https://clickhouse.com/learn)
- [Comparison](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/groupconcat)
- [BigQuery](https://clickhouse.com/comparison/bigquery)
- [PostgreSQL](https://clickhouse.com/comparison/postgresql)
- [Redshift](https://clickhouse.com/comparison/redshift)
- [Rockset](https://clickhouse.com/comparison/rockset)
- [Snowflake](https://clickhouse.com/comparison/snowflake)
- [Video](https://clickhouse.com/videos)
- [Demo](https://clickhouse.com/demos)
- [Pricing](https://clickhouse.com/pricing)
- [Contact](https://clickhouse.com/company/contact?loc=nav)
[46\.4k](https://github.com/ClickHouse/ClickHouse?utm_source=clickhouse&utm_medium=website&utm_campaign=website-nav)
[Search`Ctrl``K`](https://clickhouse.com/docs/search)
[Sign in](https://console.clickhouse.cloud/signIn?loc=docs-nav-signIn-cta)
[Get started](https://console.clickhouse.cloud/signUp?loc=docs-nav-signUp-cta)
[Get started](https://clickhouse.com/docs/introduction-clickhouse)
[Cloud](https://clickhouse.com/docs/cloud/overview)
[Manage data](https://clickhouse.com/docs/updating-data)
[Server admin](https://clickhouse.com/docs/guides/manage-and-deploy-index)
[Reference](https://clickhouse.com/docs/sql-reference)
[Integrations](https://clickhouse.com/docs/integrations)
[ClickStack](https://clickhouse.com/docs/use-cases/observability/clickstack/overview)
[chDB](https://clickhouse.com/docs/chdb)
[About](https://clickhouse.com/docs/about)
[Knowledge Base](https://clickhouse.com/docs/knowledgebase)
[English](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/groupconcat)
- [English](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/groupconcat)
- [日本語](https://clickhouse.com/docs/jp/sql-reference/aggregate-functions/reference/groupconcat)
- [中文](https://clickhouse.com/docs/zh/sql-reference/aggregate-functions/reference/groupconcat)
- [Русский](https://clickhouse.com/docs/ru/sql-reference/aggregate-functions/reference/groupconcat)
[Skip to main content](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/groupconcat#__docusaurus_skipToContent_fallback)
[](https://clickhouse.com/)
- [Products](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/groupconcat)
- [ClickHouse Cloud Best way to use ClickHouse. Available on AWS, GCP, and Azure.](https://clickhouse.com/cloud)
- [BYOC (Bring Your Own Cloud) The fully managed ClickHouse Cloud service, Can be deployed in your AWS account.](https://clickhouse.com/cloud/bring-your-own-cloud)
- [ClickHouse Set up a database with open-source ClickHouse. ClickHouse](https://clickhouse.com/clickhouse)
- [Discover more than 100 integrations.](https://clickhouse.com/integrations)
[Discover more than 100 integrations.](https://clickhouse.com/integrations)
- [Use cases](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/groupconcat)
- [Real-time analytics](https://clickhouse.com/use-cases/real-time-analytics)
- [Machine Learning & Generative AI](https://clickhouse.com/use-cases/machine-learning-and-data-science)
- [Business Intelligence](https://clickhouse.com/use-cases/data-warehousing)
- [Logs, Events, Traces](https://clickhouse.com/use-cases/observability)
- [All use cases](https://clickhouse.com/use-cases)
[All use cases](https://clickhouse.com/use-cases)
- [Documentation](https://clickhouse.com/docs)
- [Resources](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/groupconcat)
- [User stories](https://clickhouse.com/user-stories)
- [Blog](https://clickhouse.com/blog)
- [Events](https://clickhouse.com/company/events)
- [Learning and certification](https://clickhouse.com/learn)
- [Comparison](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/groupconcat)
- [BigQuery](https://clickhouse.com/comparison/bigquery)
- [PostgreSQL](https://clickhouse.com/comparison/postgresql)
- [Redshift](https://clickhouse.com/comparison/redshift)
- [Rockset](https://clickhouse.com/comparison/rockset)
- [Snowflake](https://clickhouse.com/comparison/snowflake)
- [Video](https://clickhouse.com/videos)
- [Demo](https://clickhouse.com/demos)
- [Pricing](https://clickhouse.com/pricing)
- [Contact](https://clickhouse.com/company/contact?loc=nav)
[46\.4k](https://github.com/ClickHouse/ClickHouse?utm_source=clickhouse&utm_medium=website&utm_campaign=website-nav)
[Search`Ctrl``K`](https://clickhouse.com/docs/search)
[Sign in](https://console.clickhouse.cloud/signIn?loc=docs-nav-signIn-cta)
[Get started](https://console.clickhouse.cloud/signUp?loc=docs-nav-signUp-cta)
[Get started](https://clickhouse.com/docs/introduction-clickhouse)
[Cloud](https://clickhouse.com/docs/cloud/overview)
[Manage data](https://clickhouse.com/docs/updating-data)
[Server admin](https://clickhouse.com/docs/guides/manage-and-deploy-index)
[Reference](https://clickhouse.com/docs/sql-reference)
[Integrations](https://clickhouse.com/docs/integrations)
[ClickStack](https://clickhouse.com/docs/use-cases/observability/clickstack/overview)
[chDB](https://clickhouse.com/docs/chdb)
[About](https://clickhouse.com/docs/about)
[Knowledge Base](https://clickhouse.com/docs/knowledgebase)
[English](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/groupconcat)
- [English](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/groupconcat)
- [日本語](https://clickhouse.com/docs/jp/sql-reference/aggregate-functions/reference/groupconcat)
- [中文](https://clickhouse.com/docs/zh/sql-reference/aggregate-functions/reference/groupconcat)
- [Русский](https://clickhouse.com/docs/ru/sql-reference/aggregate-functions/reference/groupconcat)
[Search`Ctrl``K`](https://clickhouse.com/docs/search)
- [Introduction](https://clickhouse.com/docs/sql-reference)
- [Syntax](https://clickhouse.com/docs/sql-reference/syntax)
- [Input and Output Formats](https://clickhouse.com/docs/sql-reference/formats)
- [Data types](https://clickhouse.com/docs/sql-reference/data-types)
- [Statements](https://clickhouse.com/docs/sql-reference/statements)
- [Operators](https://clickhouse.com/docs/sql-reference/operators)
- [Engines](https://clickhouse.com/docs/engines)
- [Database Engines](https://clickhouse.com/docs/engines/database-engines)
- [Table Engines](https://clickhouse.com/docs/engines/table-engines)
- [Functions](https://clickhouse.com/docs/sql-reference/functions)
- [Regular functions](https://clickhouse.com/docs/sql-reference/functions/regular-functions)
- [Aggregate functions](https://clickhouse.com/docs/sql-reference/aggregate-functions)
- [Aggregate Functions](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference)
- [aggThrow](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/aggthrow)
- [analysisOfVariance](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/analysis_of_variance)
- [any](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/any)
- [anyHeavy](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/anyheavy)
- [anyLast](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/anylast)
- [approx\_top\_k](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/approxtopk)
- [approx\_top\_sum](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/approxtopsum)
- [argAndMax](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/argandmax)
- [argAndMin](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/argandmin)
- [argMax](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/argmax)
- [argMin](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/argmin)
- [avg](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/avg)
- [avgWeighted](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/avgweighted)
- [boundingRatio](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/boundingRatio)
- [categoricalInformationValue](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/categoricalinformationvalue)
- [contingency](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/contingency)
- [corr](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/corr)
- [corrMatrix](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/corrmatrix)
- [corrStable](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/corrstable)
- [count](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/count)
- [covarPop](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/covarpop)
- [covarPopMatrix](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/covarpopmatrix)
- [covarPopStable](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/covarpopstable)
- [covarSamp](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/covarsamp)
- [covarSampMatrix](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/covarsampmatrix)
- [covarSampStable](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/covarsampstable)
- [cramersV](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/cramersv)
- [cramersVBiasCorrected](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/cramersvbiascorrected)
- [deltaSum](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/deltasum)
- [deltaSumTimestamp](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/deltasumtimestamp)
- [distinctDynamicTypes](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/distinctdynamictypes)
- [distinctJSONPaths](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/distinctjsonpaths)
- [distinctJSONPathsAndTypes](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/distinctJSONPathsAndTypes)
- [entropy](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/entropy)
- [estimateCompressionRatio](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/estimateCompressionRatio)
- [exponentialMovingAverage](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/exponentialMovingAverage)
- [exponentialTimeDecayedAvg](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/exponentialTimeDecayedAvg)
- [exponentialTimeDecayedCount](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/exponentialTimeDecayedCount)
- [exponentialTimeDecayedMax](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/exponentialTimeDecayedMax)
- [exponentialTimeDecayedSum](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/exponentialTimeDecayedSum)
- [first\_value](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/first_value)
- [flameGraph](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/flame_graph)
- [groupArray](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/grouparray)
- [groupArrayArray](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/grouparrayarray)
- [groupArrayInsertAt](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/grouparrayinsertat)
- [groupArrayIntersect](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/grouparrayintersect)
- [groupArrayLast](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/grouparraylast)
- [groupArrayMovingAvg](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/grouparraymovingavg)
- [groupArrayMovingSum](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/grouparraymovingsum)
- [groupArraySample](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/grouparraysample)
- [groupArraySorted](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/grouparraysorted)
- [groupBitAnd](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/groupbitand)
- [groupBitOr](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/groupbitor)
- [groupBitXor](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/groupbitxor)
- [groupBitmap](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/groupbitmap)
- [groupBitmapAnd](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/groupbitmapand)
- [groupBitmapOr](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/groupbitmapor)
- [groupBitmapXor](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/groupbitmapxor)
- [groupConcat](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/groupconcat)
- [groupUniqArray](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/groupuniqarray)
- [intervalLengthSum](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/intervalLengthSum)
- [kolmogorovSmirnovTest](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/kolmogorovsmirnovtest)
- [kurtPop](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/kurtpop)
- [kurtSamp](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/kurtsamp)
- [largestTriangleThreeBuckets](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/largestTriangleThreeBuckets)
- [last\_value](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/last_value)
- [mannWhitneyUTest](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/mannwhitneyutest)
- [max](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/max)
- [maxIntersections](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/maxintersections)
- [maxIntersectionsPosition](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/maxintersectionsposition)
- [maxMap](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/maxmap)
- [meanZTest](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/meanztest)
- [median](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/median)
- [min](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/min)
- [minMap](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/minmap)
- [quantile](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/quantile)
- [quantileBFloat16](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/quantilebfloat16)
- [quantileDD](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/quantileddsketch)
- [quantileDeterministic](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/quantiledeterministic)
- [quantileExact Functions](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/quantileexact)
- [quantileExactExclusive](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/quantileExactExclusive)
- [quantileExactHigh](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/quantileExactHigh)
- [quantileExactInclusive](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/quantileExactInclusive)
- [quantileExactLow](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/quantileExactLow)
- [quantileExactWeighted](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/quantileexactweighted)
- [quantileExactWeightedInterpolated](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/quantileExactWeightedInterpolated)
- [quantileGK](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/quantileGK)
- [quantileInterpolatedWeighted](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/quantileInterpolatedWeighted)
- [quantilePrometheusHistogram](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/quantilePrometheusHistogram)
- [quantileTDigest](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/quantiletdigest)
- [quantileTDigestWeighted](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/quantiletdigestweighted)
- [quantileTiming](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/quantiletiming)
- [quantileTimingWeighted](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/quantiletimingweighted)
- [quantiles Functions](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/quantiles)
- [quantilesExactExclusive](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/quantilesExactExclusive)
- [quantilesExactInclusive](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/quantilesExactInclusive)
- [quantilesGK](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/quantilesGK)
- [quantilesTimingWeighted](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/quantilestimingweighted)
- [rankCorr](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/rankCorr)
- [simpleLinearRegression](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/simplelinearregression)
- [singleValueOrNull](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/singlevalueornull)
- [skewPop](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/skewpop)
- [skewSamp](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/skewsamp)
- [sparkbar](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/sparkbar)
- [stddevPop](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/stddevpop)
- [stddevPopStable](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/stddevpopstable)
- [stddevSamp](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/stddevsamp)
- [stddevSampStable](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/stddevsampstable)
- [stochasticLinearRegression](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/stochasticlinearregression)
- [stochasticLogisticRegression](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/stochasticlogisticregression)
- [studentTTest](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/studentttest)
- [studentTTestOneSample](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/studentttestonesample)
- [sum](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/sum)
- [sumCount](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/sumcount)
- [sumKahan](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/sumkahan)
- [sumMapWithOverflow](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/summapwithoverflow)
- [sumMap](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/summap)
- [sumWithOverflow](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/sumwithoverflow)
- [theilsU](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/theilsu)
- [timeSeriesChangesToGrid](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/timeSeriesChangesToGrid)
- [timeSeriesDeltaToGrid](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/timeSeriesDeltaToGrid)
- [timeSeriesDerivToGrid](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/timeSeriesDerivToGrid)
- [timeSeriesGroupArray](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/timeSeriesGroupArray)
- [timeSeriesInstantDeltaToGrid](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/timeSeriesInstantDeltaToGrid)
- [timeSeriesInstantRateToGrid](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/timeSeriesInstantRateToGrid)
- [timeSeriesLastTwoSamples](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/timeSeriesLastTwoSamples)
- [timeSeriesPredictLinearToGrid](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/timeSeriesPredictLinearToGrid)
- [timeSeriesRateToGrid](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/timeSeriesRateToGrid)
- [timeSeriesResampleToGridWithStaleness](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/timeSeriesResampleToGridWithStaleness)
- [timeSeriesResetsToGrid](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/timeSeriesResetsToGrid)
- [topK](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/topk)
- [topKWeighted](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/topkweighted)
- [uniq](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/uniq)
- [uniqCombined](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/uniqcombined)
- [uniqCombined64](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/uniqcombined64)
- [uniqExact](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/uniqexact)
- [uniqHLL12](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/uniqhll12)
- [uniqTheta](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/uniqthetasketch)
- [varPop](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/varPop)
- [varPopStable](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/varpopstable)
- [varSamp](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/varSamp)
- [varSampStable](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/varsampstable)
- [welchTTest](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/welchttest)
- [Combinators](https://clickhouse.com/docs/sql-reference/aggregate-functions/combinators)
- [Parametric](https://clickhouse.com/docs/sql-reference/aggregate-functions/parametric-functions)
- [GROUPING](https://clickhouse.com/docs/sql-reference/aggregate-functions/grouping_function)
- [Combinator examples](https://clickhouse.com/docs/examples/aggregate-function-combinators/anyIf)
- [Table functions](https://clickhouse.com/docs/sql-reference/table-functions)
- [Window functions](https://clickhouse.com/docs/sql-reference/window-functions)
- [Formats](https://clickhouse.com/docs/interfaces/formats)
- [Data Lakes](https://clickhouse.com/docs/sql-reference/datalakes)
- [Functions](https://clickhouse.com/docs/sql-reference/functions)
- [Aggregate functions](https://clickhouse.com/docs/sql-reference/aggregate-functions)
- [Aggregate Functions](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference)
- groupConcat
[Edit this page](https://github.com/ClickHouse/ClickHouse/tree/master/docs/en/sql-reference/aggregate-functions/reference/groupConcat.md)
# groupConcat
## groupConcat[](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/groupconcat#groupConcat "Direct link to groupConcat")
Introduced in: v24.8.0
Calculates a concatenated string from a group of strings, optionally separated by a delimiter, and optionally limited by a maximum number of elements.
Note
If delimiter is specified without limit, it must be the first parameter. If both delimiter and limit are specified, delimiter must precede limit.
Also, if different delimiters are specified as parameters and arguments, the delimiter from arguments will be used only.
**Syntax**
```
groupConcat[(delimiter [, limit])](expression)
```
**Aliases**: `group_concat`
**Parameters**
- `delimiter` — A string that will be used to separate concatenated values. This parameter is optional and defaults to an empty string if not specified. [`String`](https://clickhouse.com/docs/sql-reference/data-types/string)
- `limit` — A positive integer specifying the maximum number of elements to concatenate. If more elements are present, excess elements are ignored. This parameter is optional. [`UInt*`](https://clickhouse.com/docs/sql-reference/data-types/int-uint)
**Arguments**
- `expression` — The expression or column name that outputs strings to be concatenated. [`String`](https://clickhouse.com/docs/sql-reference/data-types/string)
- `delimiter` — A string that will be used to separate concatenated values. This parameter is optional and defaults to an empty string or delimiter from parameters if not specified. [`String`](https://clickhouse.com/docs/sql-reference/data-types/string)
**Returned value**
Returns a string consisting of the concatenated values of the column or expression. If the group has no elements or only null elements, and the function does not specify a handling for only null values, the result is a nullable string with a null value. [`String`](https://clickhouse.com/docs/sql-reference/data-types/string)
**Examples**
**Basic usage without a delimiter**
```
SELECT groupConcat(Name) FROM Employees;
```
```
JohnJaneBob
```
**Using comma as a delimiter (parameter syntax)**
```
SELECT groupConcat(', ')(Name) FROM Employees;
```
```
John, Jane, Bob
```
**Using comma as a delimiter (argument syntax)**
```
SELECT groupConcat(Name, ', ') FROM Employees;
```
```
John, Jane, Bob
```
**Limiting the number of concatenated elements**
```
SELECT groupConcat(', ', 2)(Name) FROM Employees;
```
```
John, Jane
```
[Previous groupBitmapXor](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/groupbitmapxor)
[Next groupUniqArray](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/groupuniqarray)
- [groupConcat](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/groupconcat#groupConcat)
Was this page helpful?
© 2016–2026 ClickHouse, Inc.
[Trademark](https://clickhouse.com/legal/trademark-policy)·[Privacy](https://clickhouse.com/legal/privacy-policy)·[Security](https://trust.clickhouse.com/)·[Terms of Service](https://clickhouse.com/legal/agreements/terms-of-service)

© 2016–2026 ClickHouse, Inc.
[Trademark](https://clickhouse.com/legal/trademark-policy)·[Privacy](https://clickhouse.com/legal/privacy-policy)·[Security](https://trust.clickhouse.com/)·[Terms of Service](https://clickhouse.com/legal/agreements/terms-of-service)
 |
| Readable Markdown | ## groupConcat[](https://clickhouse.com/docs/sql-reference/aggregate-functions/reference/groupconcat#groupConcat "Direct link to groupConcat")
Introduced in: v24.8.0
Calculates a concatenated string from a group of strings, optionally separated by a delimiter, and optionally limited by a maximum number of elements.
Note
If delimiter is specified without limit, it must be the first parameter. If both delimiter and limit are specified, delimiter must precede limit.
Also, if different delimiters are specified as parameters and arguments, the delimiter from arguments will be used only.
**Syntax**
```
groupConcat[(delimiter [, limit])](expression)
```
**Aliases**: `group_concat`
**Parameters**
- `delimiter` — A string that will be used to separate concatenated values. This parameter is optional and defaults to an empty string if not specified. [`String`](https://clickhouse.com/docs/sql-reference/data-types/string)
- `limit` — A positive integer specifying the maximum number of elements to concatenate. If more elements are present, excess elements are ignored. This parameter is optional. [`UInt*`](https://clickhouse.com/docs/sql-reference/data-types/int-uint)
**Arguments**
- `expression` — The expression or column name that outputs strings to be concatenated. [`String`](https://clickhouse.com/docs/sql-reference/data-types/string)
- `delimiter` — A string that will be used to separate concatenated values. This parameter is optional and defaults to an empty string or delimiter from parameters if not specified. [`String`](https://clickhouse.com/docs/sql-reference/data-types/string)
**Returned value**
Returns a string consisting of the concatenated values of the column or expression. If the group has no elements or only null elements, and the function does not specify a handling for only null values, the result is a nullable string with a null value. [`String`](https://clickhouse.com/docs/sql-reference/data-types/string)
**Examples**
**Basic usage without a delimiter**
```
SELECT groupConcat(Name) FROM Employees;
```
```
JohnJaneBob
```
**Using comma as a delimiter (parameter syntax)**
```
SELECT groupConcat(', ')(Name) FROM Employees;
```
```
John, Jane, Bob
```
**Using comma as a delimiter (argument syntax)**
```
SELECT groupConcat(Name, ', ') FROM Employees;
```
```
John, Jane, Bob
```
**Limiting the number of concatenated elements**
```
SELECT groupConcat(', ', 2)(Name) FROM Employees;
```
```
John, Jane
``` |
| Shard | 89 (laksa) |
| Root Hash | 12633450985039531489 |
| Unparsed URL | com,clickhouse!/docs/sql-reference/aggregate-functions/reference/groupconcat s443 |