These are the docs for the Metabase master branch. Some features documented here may not yet be available in the latest release. Check out the docs for the latest version, Metabase v0.51.

Concat

concat concatenates data from two or more columns or values, and returns a string.

Syntax

concat(value1, value2, ...)

value1, value2 … can be columns or values. Metabase will convert non-string columns into strings before concatenating their values.

Example

Expression Result
concat("Vienna", "Austria") "ViennaAustria"
concat("Vienna", " is in " ,"Austria") "Vienna is in Austria"
concat([City], " is in " ,[Country]) "Vienna is in Austria"

Metabase will use unformatted values for non-string columns

When you use non-string columns in concat, Metabase will ignore any formatting that you applied to the columns when converting the column to a string.

For example, if you formatted a number to display only the first two decimal digits in the table results, the results of concat would still include additional decimal digits (if any) found in the raw results.

Formatted display Value concat("Result:", " ", [Value])
Kitten Kitten Result: Kitten
17 17 Result: 17
31.25 31.24823945 Result: 31.24823945
42% 0.42 Result: 0.42
January 1, 2024 2025-02-11 21:40:27.892 Result: 31.24823945

Accepted data types

Data type Works with concat
String
Number
Timestamp
Boolean
JSON

Non-string types will be converted to strings. Regardless of the type of the value passed to concat, the result will be a string.

This section covers functions and formulas that work the same way as the Metabase concat expression, with notes on how to choose the best option for your use case.

SQL

In most cases (unless you’re using a NoSQL database), questions created from the notebook editor are converted into SQL queries that run against your database or data warehouse.

If our sample data is stored in a relational database:

SELECT
    CONCAT(City, ", ", Country) AS "Location"
FROM
    richard_linklater_films;

is equivalent to the Metabase concat expression:

concat([City], ", ", [Country])

Spreadsheets

If our sample data is in a spreadsheet where “City” is in column A, and “Country” in column B, we can create a third column “Location” like this:

=CONCATENATE(A2, ", ", B2)

which is equivalent to the Metabase concat expression:

concat([City], ", ", [Country])

Python

Assuming the sample data is in a dataframe column called df:

df["Location"] = df["City"] + ", " + df["Country"]

is the same as the Metabase concat expression:

concat([City], ", ", [Country])

Further reading

Read docs for other versions of Metabase.

Want to improve these docs? Propose a change.