Background
According to the Dataform documentation, the metadata property can add metadata to a table in Knowledge Catalog.
For example:
config {
type: "table",
metadata: {
overview: "This table provides standardized trip data."
}
}
Steps to reproduce
- Define a Dataform table with a non-empty
metadata.overview value, as shown above.
- Execute the workflow:
- locally using
dataform run; or
- through the Dataform UI in Google Cloud Console.
- Wait for the table and its Knowledge Catalog entry to be updated.
- Open the table in Knowledge Catalog and inspect its overview metadata.
Expected behavior
Knowledge Catalog displays the value configured in metadata.overview:
This table provides standardized trip data.
Actual behavior
The table is created or updated successfully, but the configured overview is not displayed in Knowledge Catalog.
No error or warning indicating that metadata propagation failed is shown.
Environment
- Dataform Core version: 3.0.70
- Execution method: Local CLI and Google Cloud Dataform
- Google Cloud project region: US
- Repository region: US
- BigQuery dataset region: US
- First observed: August 31, 2026
Additional information
- Does the executing service account have the required Knowledge Catalog permissions? yes
- How long did you wait before checking Knowledge Catalog? 10 mins
- Does this also occur with a newly created table rather than an existing table? no
- Does other metadata, such as column descriptions, propagate successfully? yes
Background
According to the Dataform documentation, the
metadataproperty can add metadata to a table in Knowledge Catalog.For example:
config { type: "table", metadata: { overview: "This table provides standardized trip data." } }Steps to reproduce
metadata.overviewvalue, as shown above.dataform run; orExpected behavior
Knowledge Catalog displays the value configured in
metadata.overview:Actual behavior
The table is created or updated successfully, but the configured overview is not displayed in Knowledge Catalog.
No error or warning indicating that metadata propagation failed is shown.
Environment
Additional information