Organise your project with tags

Learn how to organise your project with tags.


Tags allow you to easily refer to a collection of actions. This can be useful in creating schedules and triggering runs.


Suppose we would like to add a "daily" tag to a dataset.

To add a tag to a dataset:

1config {
2  type: "table",
3  name: "users",
4  tags: ["daily"]

Alternatively you can use the JavaScript API:

1publish("users").query("SELECT ...").tags(["daily"]);

Tags can be added to datasets, assertions, operations and declarations.

You can add more than one tag to each action like so:

1config {
2  type: "view",
3  name: "user_counts",
4  tags: ["daily", "view"]

Using tags

Once you have assigned tags to actions, you can use the tags to define a run or schedule . For example, in the schedule creation screen, simply choose the tags you'd like to include in that schedule.

Tags can also be used with the CLI using the --tags argument.

What's next

Publish data tables and views

Learn how to configure, publish and document data tables in your warehouse.


Learn about the structure and features of SQLX files.

Test data quality with assertions

Learn how to test data quality with assertions.

Declare external datasets with declarations

Learn how to declare external datasets with declarations.

Write custom SQL operations

Learn how to define custom SQL operations in Dataform.

Configure your project

Learn how to configure your Dataform project.

Power your code with JavaScript

Learn how you can use JavaScript to re-use code across your scripts and define several actions.

Run unit tests on your queries

Learn how to run unit tests on your queries.

Configure CI/CD

Configure continuous integration/deployment workflows for your Dataform project.