# dbt docs not showing macros?

**URL:** <https://discourse.getdbt.com/t/dbt-docs-not-showing-macros/8029>\
**Category:** Help\
**Tags:** documentation, macros\
**Created:** [April 26, 2023, 5:27pm UTC](https://discourse.getdbt.com/t/dbt-docs-not-showing-macros/8029 "2023-04-26T17:27:06Z")\
**Posts on this page:** 3\
**Page:** 1

<div class="post-metadata">

**Author:** ![riolo](https://avatars.discourse-cdn.com/v4/letter/r/ee59a6/32.png) [@riolo](https://discourse.getdbt.com/u/riolo)\
**Post date:** [April 26, 2023, 5:27pm UTC](https://discourse.getdbt.com/t/dbt-docs-not-showing-macros/8029/1 "2023-04-26T17:27:06Z")

</div>

I’ve got a .yml file (located under the `macros` directory) set up as described in:

> **[How do I document macros? | dbt Developer Hub](https://docs.getdbt.com/faqs/docs/documenting-macros)**
>
> You can use a schema file to document macros

`dbt docs generate` and `dbt docs serve` both run without errors, but the macros don’t show up anywhere in the resulting documents.

I also tried setting

```auto
docs:
      show: true

```

on each of the macros, based on [Macro properties | dbt Developer Hub](https://docs.getdbt.com/reference/macro-properties), but that didn’t do anything.

Is there a step I’m missing? Something we need to configure dbt\_projects.yml to specify that we have schema files under `macros/` as well as `models/`?

---

<div class="post-metadata">

**Author:** ![riolo](https://avatars.discourse-cdn.com/v4/letter/r/ee59a6/32.png) [@riolo](https://discourse.getdbt.com/u/riolo)\
**Post date:** [May 5, 2023, 5:54pm UTC](https://discourse.getdbt.com/t/dbt-docs-not-showing-macros/8029/2 "2023-05-05T17:54:11Z")

</div>

Figured out what I was doing wrong: I needed to `dbt compile` the whole project. After that, macros show up as a section under “Projects \> [our project name”.

---

<div class="post-metadata">

**Author:** ![system](https://us1.discourse-cdn.com/flex020/uploads/getdbt/original/1X/a7a7ca1fe379aaf90952b0e13118a817babcd14f.png) [@system](https://discourse.getdbt.com/u/system)\
**Post date:** [May 12, 2023, 5:54pm UTC](https://discourse.getdbt.com/t/dbt-docs-not-showing-macros/8029/3 "2023-05-12T17:54:22Z")

</div>

This topic was automatically closed 7 days after the last reply. New replies are no longer allowed.