The problem I’m having I am using the doc macro in my YML file. I need to use the column definition (retrieve the doc() result) into a custom macro, but the doc is undefined. The context of why I’m trying to do this I would like to generate the SQL file from the YML file. Because I do not want to…

Apparently known issue from the Snowflake-Labs support persist_docs to document dimension/fact/metric descriptions · Issue #12 · Snowflake-Labs/dbt_semantic_view

Multiple things: Can you share your dbt_project.yml? Do you have the docs-path defined? It is not being defined by default in there: docs-paths | dbt Developer Hub . What if you let dbt handle the docs persisting via persist_docs and just updated the table with the synonyms?

Hello, Thank you for the quick answer. this is the requested file. name: 'dbt_sandbox' version: '1.0.0' profile: 'snow_db' model-paths: ["models"] analysis-paths: ["analyses"] test-paths: ["tests"] seed-paths: ["seeds"] macro-paths: ["macros"] snapshot-paths: ["snapshots"] docs-paths: ["docs"] cl…

[image] matej.novak: What if you let dbt handle the docs persisting via persist_docs and just updated the table with the synonyms? This is not part of my use case, I really need to add the description on the COMMENT section of my generated SQL. I would like to add the column description from…

I would like to add the column description from the YML file on the comment section of the “semantic view” object from snowflake. Ok get that now. So you are basically generating views as a posthook (?) and not as a model, thats why the persist docs doesn’t work - sorry. Can this somehow fit in wi…

[image] matej.novak: Ok get that now. So you are basically generating views as a posthook (?) and not as a model, thats why the persist docs doesn’t work - sorry. You are right I am using it like a posthook (I do run it manually at the moment) [image] matej.novak: I would be surprised an…

This Execute is only here to tell us if we are in parsing mode or run mode, right? This won’t “execute” anything. right? Yes exactly. I’m not saying that docs are not working when calling a posthook, im saying im unfamiliar with when the docs are passed to the COMMENTs and how (because what you a…

[image] msaeli: dbt run-operation generate_semantic_view To clarify my request I have added the way I do run my macro. Might be a better way to call it, and being able to get the doc() related to each fields. I would be more than happy to update my macro. Regards,

using doc macro in yml file is not executed on macro

Help

msaeli March 9, 2026, 10:25am 2

This issue might be identical.

Is there any update on this ?

Rendering Macro within Macro - Help - dbt Community Forum

Topic		Replies	Views
Using doc blocks on macros description in source yml file Help	0	366	November 22, 2024
dbt docs not showing macros? Help documentation , macros	1	2144	May 5, 2023
Column macro created description for Snowflake using DBT Help snowflake , dbt-core	0	339	August 20, 2024
'doc' is undefined - when using the doc macro within a markdown file - is this expected? Help documentation , dbt-docs	0	399	March 24, 2025
Reference macros in YAML docs _without_ calling them Help jinja	1	2284	April 25, 2023

using doc macro in yml file is not executed on macro

Related topics