Skip to main content


Tags are named references to specific commits, so you can refer to the state of data at a specific point in time using a simple name instead of a commit’s hexadecimal value. For example, you could create a tag Q1FY23 to refer to the version of data that was used for calculating financial reports for the first quarter of the 2023 fiscal year. Tags always point to the same commit.

Viewing Tags

To view tags in your catalog:

  1. Select the Sonar project that contains your Arctic catalog.
  2. In the left hand side of the Datasets page, click on the name of your Arctic catalog.
  3. On the upper right of your Arctic catalog page, click the History button.
  4. On the top of the page, click the Tags button.

Creating Tags

You can use the CREATE TAG command to create a tag. For example:

CREATE TAG Q1FY23 AT COMMIT "098a092384fa489283498acdfeffba1411287941"

Tag names must be unique in the catalog. Tag names cannot be the same as branch names. To learn more about the CREATE TAG command, visit the SQL Reference.

Querying Tags

You can query data at a certain tag by referencing it as part of your query. For example:

SELECT * FROM GnarlyCatalog.Sales AT TAG Q1FY23

To learn more about querying tags, visit the SQL Reference and API Reference.

Deleting Tags

You can delete a tag using the DROP TAG command. For example:


To learn more about the DROP TAG command, visit the SQL Reference.