From b70d801a553bf122a4387ab4c9a157b238074fcf Mon Sep 17 00:00:00 2001
From: mirnawong1 <mirnawong@gmail.com>
Date: Tue, 1 Oct 2024 12:42:59 +0100
Subject: [PATCH 01/23] update configs

---
 website/docs/reference/snapshot-configs.md | 236 ++++++++++++++-------
 1 file changed, 155 insertions(+), 81 deletions(-)

diff --git a/website/docs/reference/snapshot-configs.md b/website/docs/reference/snapshot-configs.md
index 5afe429cfb4..2c3e6b665b1 100644
--- a/website/docs/reference/snapshot-configs.md
+++ b/website/docs/reference/snapshot-configs.md
@@ -20,7 +20,6 @@ Parts of a snapshot:
 -->
 
 ## Available configurations
-### Snapshot-specific configurations
 
 <ConfigResource meta={frontMatter.meta} />
 
@@ -80,8 +79,36 @@ snapshots:
 
 <TabItem value="property-yaml">
 
+<VersionBlock lastVersion="1.8">
+
 **Note:** Required snapshot properties _will not_ work when defined in `config` YAML blocks. We recommend that you define these in `dbt_project.yml` or a `config()` block within the snapshot `.sql` file.
 
+For faster and more efficient management, consider the updated snapshot YAML syntax, [available in Versionless](/docs/dbt-versions/versionless-cloud) or the [latest version of dbt Core](/docs/dbt-versions/core).
+
+</VersionBlock>
+
+<VersionBlock firstVersion="1.9">
+
+Refer to [configuring snapshots](/docs/build/snapshots#configuring-snapshots) for the available configurations.
+
+<File name="snapshots/my_snapshots.yml">
+  
+```yaml
+snapshots:
+  - name: snapshot_name
+    relation: source('my_source', 'my_table')
+    config:
+      schema: string
+      database: string
+      unique_key: column_name_or_expression
+      strategy: timestamp | check
+      updated_at: column_name  # Required if strategy is 'timestamp'
+      check_cols: [column_name] | 'all'  # Required if strategy is 'check'
+      invalidate_hard_deletes: true | false
+```
+</File>
+</VersionBlock>
+
 </TabItem>
 
 <TabItem value="config">
@@ -160,6 +187,7 @@ snapshots:
 
 <TabItem value="property-yaml">
 
+<VersionBlock lastVersion="1.8">
 <File name='snapshots/properties.yml'>
 
 ```yaml
@@ -178,6 +206,29 @@ snapshots:
 ```
 
 </File>
+</VersionBlock>
+
+<VersionBlock firsttVersion="1.9">
+<File name='snapshots/properties.yml'>
+
+```yaml
+version: 2
+
+snapshots:
+  - name: [<snapshot-name>]
+    relation: source('my_source', 'my_table')
+    config:
+      [enabled](/reference/resource-configs/enabled): true | false
+      [tags](/reference/resource-configs/tags): <string> | [<string>]
+      [alias](/reference/resource-configs/alias): <string>
+      [pre-hook](/reference/resource-configs/pre-hook-post-hook): <sql-statement> | [<sql-statement>]
+      [post-hook](/reference/resource-configs/pre-hook-post-hook): <sql-statement> | [<sql-statement>]
+      [persist_docs](/reference/resource-configs/persist_docs): {<dict>}
+      [grants](/reference/resource-configs/grants): {<dictionary>}
+```
+
+</File>
+</VersionBlock>
 
 </TabItem>
 
@@ -206,98 +257,121 @@ snapshots:
 ## Configuring snapshots
 Snapshots can be configured in one of three ways:
 
-1. Using a `config` block within a snapshot
-2. Using a `config` [resource property](/reference/model-properties) in a `.yml` file
-3. From the `dbt_project.yml` file, under the `snapshots:` key. To apply a configuration to a snapshot, or directory of snapshots, define the resource path as nested dictionary keys.
+1. Defined in YAML files, typically in your snapshots directory (available in [Versionless](/docs/dbt-versions/versionless-cloud) or and dbt Core v1.9 and higher).
+2. Using a `config` block within a snapshot
+3. Using a `config` [resource property](/reference/model-properties) in a `.yml` file
+4. From the `dbt_project.yml` file, under the `snapshots:` key. To apply a configuration to a snapshot, or directory of snapshots, define the resource path as nested dictionary keys.
 
 Snapshot configurations are applied hierarchically in the order above.
 
 ### Examples
-#### Apply configurations to all snapshots
-To apply a configuration to all snapshots, including those in any installed [packages](/docs/build/packages), nest the configuration directly under the `snapshots` key:
+The following examples demonstrate how to configure snapshots using the `dbt_project.yml` file, a `config` block within a snapshot, and a `.yml` file.
 
-<File name='dbt_project.yml'>
-
-```yml
-
-snapshots:
-  +unique_key: id
-```
-
-</File>
+- #### Apply configurations to all snapshots
+  To apply a configuration to all snapshots, including those in any installed [packages](/docs/build/packages), nest the configuration directly under the `snapshots` key:
 
+    <File name='dbt_project.yml'>
 
-#### Apply configurations to all snapshots in your project
-To apply a configuration to all snapshots in your project only (for example, _excluding_ any snapshots in installed packages), provide your project name as part of the resource path.
+    ```yml
 
-For a project named `jaffle_shop`:
+    snapshots:
+      +unique_key: id
+    ```
 
-<File name='dbt_project.yml'>
+    </File>
 
-```yml
+- #### Apply configurations to all snapshots in your project
+  To apply a configuration to all snapshots in your project only (for example, _excluding_ any snapshots in installed packages), provide your project name as part of the resource path.
 
-snapshots:
-  jaffle_shop:
-    +unique_key: id
-```
+  For a project named `jaffle_shop`:
 
-</File>
-
-Similarly, you can use the name of an installed package to configure snapshots in that package.
-
-#### Apply configurations to one snapshot only
-
-We recommend using `config` blocks if you need to apply a configuration to one snapshot only.
-
-<File name='snapshots/postgres_app/orders_snapshot.sql'>
-
-```sql
-{% snapshot orders_snapshot %}
-    {{
-        config(
-          unique_key='id',
-          strategy='timestamp',
-          updated_at='updated_at'
-        )
-    }}
-    -- Pro-Tip: Use sources in snapshots!
-    select * from {{ source('jaffle_shop', 'orders') }}
-{% endsnapshot %}
-```
-
-</File>
+    <File name='dbt_project.yml'>
 
-You can also use the full resource path (including the project name, and subdirectories) to configure an individual snapshot from your `dbt_project.yml` file.
+    ```yml
 
-For a project named `jaffle_shop`, with a snapshot file within the `snapshots/postgres_app/` directory, where the snapshot is named `orders_snapshot` (as above), this would look like:
-
-<File name='dbt_project.yml'>
-
-```yml
-snapshots:
-  jaffle_shop:
-    postgres_app:
-      orders_snapshot:
+    snapshots:
+      jaffle_shop:
         +unique_key: id
-        +strategy: timestamp
-        +updated_at: updated_at
-```
-
-</File>
-
-You can also define some common configs in a snapshot's `config` block. We don't recommend this for a snapshot's required configuration, however.
-
-<File name='dbt_project.yml'>
-
-```yml
-version: 2
-
-snapshots:
-  - name: orders_snapshot
-    config:
-      persist_docs:
-        relation: true
-        columns: true
-```
-
-</File>
+    ```
+
+    </File>
+
+  Similarly, you can use the name of an installed package to configure snapshots in that package.
+
+- #### Apply configurations to one snapshot only
+  
+  <VersionBlock lastVersion="1.8">
+  We recommend using `config` blocks if you need to apply a configuration to one snapshot only.
+
+    <File name='snapshots/postgres_app/orders_snapshot.sql'>
+
+    ```sql
+    {% snapshot orders_snapshot %}
+        {{
+            config(
+              unique_key='id',
+              strategy='timestamp',
+              updated_at='updated_at'
+            )
+        }}
+        -- Pro-Tip: Use sources in snapshots!
+        select * from {{ source('jaffle_shop', 'orders') }}
+    {% endsnapshot %}
+    ```
+
+    </File>
+    </VersionBlock>
+
+    <VersionBlock firstVersion="1.9">
+     <File name='snapshots/postgres_app/your_snapshot_name.yml'>
+
+    ```yaml
+    snapshots:
+     - name: orders_snapshot
+       relation: source('jaffle_shop', 'orders')
+       config:
+         unique_key: id
+         strategy: timestamp
+         updated_at: updated_at
+         persist_docs:
+           relation: true
+           columns: true
+    ```
+    </File>
+   Pro-tip: Use sources in snapshots: `select * from {{ source('jaffle_shop', 'orders') }}`
+    </VersionBlock>
+
+  You can also use the full resource path (including the project name, and subdirectories) to configure an individual snapshot from your `dbt_project.yml` file.
+
+  For a project named `jaffle_shop`, with a snapshot file within the `snapshots/postgres_app/` directory, where the snapshot is named `orders_snapshot` (as above), this would look like:
+
+    <File name='dbt_project.yml'>
+
+    ```yml
+    snapshots:
+      jaffle_shop:
+        postgres_app:
+          orders_snapshot:
+            +unique_key: id
+            +strategy: timestamp
+            +updated_at: updated_at
+    ```
+
+    </File>
+
+  You can also define some common configs in a snapshot's `config` block. We don't recommend this for a snapshot's required configuration, however.
+
+    <File name='dbt_project.yml'>
+
+    ```yml
+    version: 2
+
+    snapshots:
+      - name: orders_snapshot
+        config:
+          persist_docs:
+            relation: true
+            columns: true
+    ```
+
+    </File>

From 66f65b5191a80fddf52578aaa015631264e39fd7 Mon Sep 17 00:00:00 2001
From: mirnawong1 <mirnawong@gmail.com>
Date: Tue, 1 Oct 2024 12:51:30 +0100
Subject: [PATCH 02/23] add properites adn configs

---
 website/docs/reference/snapshot-configs.md    |  4 +-
 website/docs/reference/snapshot-properties.md | 51 ++++++++++++++++++-
 2 files changed, 52 insertions(+), 3 deletions(-)

diff --git a/website/docs/reference/snapshot-configs.md b/website/docs/reference/snapshot-configs.md
index 2c3e6b665b1..f7005021940 100644
--- a/website/docs/reference/snapshot-configs.md
+++ b/website/docs/reference/snapshot-configs.md
@@ -83,7 +83,7 @@ snapshots:
 
 **Note:** Required snapshot properties _will not_ work when defined in `config` YAML blocks. We recommend that you define these in `dbt_project.yml` or a `config()` block within the snapshot `.sql` file.
 
-For faster and more efficient management, consider the updated snapshot YAML syntax, [available in Versionless](/docs/dbt-versions/versionless-cloud) or the [latest version of dbt Core](/docs/dbt-versions/core).
+For faster and more efficient management, consider the updated snapshot YAML syntax, [available in Versionless](/docs/dbt-versions/versionless-cloud) or [dbt v1.9 and later](/docs/dbt-versions/core).
 
 </VersionBlock>
 
@@ -208,7 +208,7 @@ snapshots:
 </File>
 </VersionBlock>
 
-<VersionBlock firsttVersion="1.9">
+<VersionBlock firstVersion="1.9">
 <File name='snapshots/properties.yml'>
 
 ```yaml
diff --git a/website/docs/reference/snapshot-properties.md b/website/docs/reference/snapshot-properties.md
index 49769af8f6d..54c1083e4b4 100644
--- a/website/docs/reference/snapshot-properties.md
+++ b/website/docs/reference/snapshot-properties.md
@@ -3,12 +3,60 @@ title: Snapshot properties
 description: "Read this guide to learn about using source properties in dbt."
 ---
 
+<VersionBlock firstVersion="1.9">
+
+In Versionless and dbt v1.9 and later, snapshots are defined and configured in YAML files within your `snapshots/` directory (as defined by the [`snapshot-paths` config](/reference/project-configs/snapshot-paths)). Snapshot properties are declared within these YAML files, allowing you to define both the snapshot configurations and properties in one place.
+
+</VersionBlock>
+
+<VersionBlock lastVersion="1.8">
+
 Snapshots properties can be declared in `.yml` files in:
-- your `snapshots/` directory (as defined by the [`snapshot-paths` config](/reference/project-configs/snapshot-paths))
+- your `snapshots/` directory (as defined by the [`snapshot-paths` config](/reference/project-configs/snapshot-paths)).
 - your `models/` directory (as defined by the [`model-paths` config](/reference/project-configs/model-paths))
 
+</VersionBlock>
+
 We recommend that you put them in the `snapshots/` directory. You can name these files `whatever_you_want.yml`, and nest them arbitrarily deeply in subfolders within the `snapshots/` or `models/` directory.
 
+<VersionBlock firstVersion="1.9">
+
+<File name='snapshots/<filename>.yml'>
+
+```yml
+version: 2
+
+snapshots:
+  - name: <snapshot name>
+    [description](/reference/resource-properties/description): <markdown_string>
+    [meta](/reference/resource-configs/meta): {<dictionary>}
+    [docs](/reference/resource-configs/docs):
+      show: true | false
+      node_color: <color_id> # Use name (such as node_color: purple) or hex code with quotes (such as node_color: "#cd7f32")
+    [config](/reference/resource-properties/config):
+      [<snapshot_config>](/reference/snapshot-configs): <config_value>
+    [tests](/reference/resource-properties/data-tests):
+      - <test>
+      - ...
+    columns:
+      - name: <column name>
+        [description](/reference/resource-properties/description): <markdown_string>
+        [meta](/reference/resource-configs/meta): {<dictionary>}
+        [quote](/reference/resource-properties/quote): true | false
+        [tags](/reference/resource-configs/tags): [<string>]
+        [tests](/reference/resource-properties/data-tests):
+          - <test>
+          - ... # declare additional tests
+      - ... # declare properties of additional columns
+
+    - name: ... # declare properties of additional snapshots
+
+```
+</File>
+</VersionBlock>
+
+<VersionBlock lastVersion="1.8">
+
 <File name='snapshots/<filename>.yml'>
 
 ```yml
@@ -41,3 +89,4 @@ snapshots:
 
 ```
 </File>
+</VersionBlock>

From c6996093fc272cb1d969399d2055e1018fbc64fc Mon Sep 17 00:00:00 2001
From: mirnawong1 <mirnawong@gmail.com>
Date: Tue, 1 Oct 2024 14:17:28 +0100
Subject: [PATCH 03/23] update all content under snapshots

---
 .../docs/reference/configs-and-properties.md  |  11 +-
 .../reference/resource-configs/check_cols.md  |  76 ++++++++++++-
 .../invalidate_hard_deletes.md                |  48 ++++++++
 .../resource-configs/pre-hook-post-hook.md    |   6 +-
 .../resource-configs/snapshot_name.md         |  51 ++++++++-
 .../reference/resource-configs/strategy.md    | 105 ++++++++++++++++++
 .../reference/resource-configs/unique_key.md  | 101 ++++++++++++++++-
 .../reference/resource-configs/updated_at.md  |  89 ++++++++++++++-
 website/docs/reference/snapshot-configs.md    |   2 +-
 9 files changed, 482 insertions(+), 7 deletions(-)

diff --git a/website/docs/reference/configs-and-properties.md b/website/docs/reference/configs-and-properties.md
index 20d762b7462..b3f23584a4a 100644
--- a/website/docs/reference/configs-and-properties.md
+++ b/website/docs/reference/configs-and-properties.md
@@ -26,9 +26,18 @@ Whereas you can use **configurations** to:
 
 Depending on the resource type, configurations can be defined in the dbt project and also in an installed package by:
 
+<VersionBlock firstVersion="1.9">
+
+1. Using a [`config` property](/reference/resource-properties/config) in a `.yml` file in the `models/`, `snapshots/`, or `tests/` directory
+2. From the [`dbt_project.yml` file](dbt_project.yml), under the corresponding resource key (`models:`, `snapshots:`, `tests:`, etc)
+</VersionBlock>
+
+<VersionBlock lastVersion="1.8">
+
 1. Using a [`config()` Jinja macro](/reference/dbt-jinja-functions/config) within a `model`, `snapshot`, or `test` SQL file
-2. Using a [`config` property](/reference/resource-properties/config) in a `.yml` file
+2. Using a [`config` property](/reference/resource-properties/config) in a `.yml` file in the `models/`, `snapshots/`, or `tests/` directory.
 3. From the [`dbt_project.yml` file](dbt_project.yml), under the corresponding resource key (`models:`, `snapshots:`, `tests:`, etc)
+</VersionBlock>
 
 ### Config inheritance
 
diff --git a/website/docs/reference/resource-configs/check_cols.md b/website/docs/reference/resource-configs/check_cols.md
index bd187409379..b8e7ae8398f 100644
--- a/website/docs/reference/resource-configs/check_cols.md
+++ b/website/docs/reference/resource-configs/check_cols.md
@@ -3,6 +3,31 @@ resource_types: [snapshots]
 description: "Read this guide to understand the check_cols configuration in dbt."
 datatype: "[column_name] | all"
 ---
+
+<VersionBlock firstVersion="1.9">
+<File name="snapshots/<filename>.yml">
+  
+  ```yml
+  snapshots:
+  - name: snapshot_name
+    relation: source('jaffle_shop', 'orders')
+    config:
+      schema: string
+      unique_key: column_name_or_expression
+      strategy: check
+      check_cols:
+        - column_name
+  ```
+  
+</File>
+</VersionBlock>
+
+<VersionBlock lastVersion="1.8">
+
+:::info Use the latest snapshot syntax
+
+In Versionless and dbt v1.9 and later, snapshots are defined in an updated syntax using a YAML file within your `snapshots/` directory (as defined by the [`snapshot-paths` config](/reference/project-configs/snapshot-paths)). For faster and more efficient management, consider the updated snapshot YAML syntax, [available in Versionless](/docs/dbt-versions/versionless-cloud) or [dbt Core v1.9 and later](/docs/dbt-versions/core).
+:::
 <File name='snapshots/<filename>.sql'>
 
 ```jinja2
@@ -14,7 +39,7 @@ datatype: "[column_name] | all"
 ```
 
 </File>
-
+</VersionBlock>
 
 <File name='dbt_project.yml'>
 
@@ -42,6 +67,30 @@ No default is provided.
 
 ### Check a list of columns for changes
 
+<VersionBlock firstVersion="1.9">
+
+<File name="snapshots/orders_snapshot_check.yml">
+
+```yaml
+snapshots:
+  - name: orders_snapshot_check
+    relation: source('jaffle_shop', 'orders')
+    config:
+      schema: snapshots
+      unique_key: id
+      strategy: check
+      check_cols:
+        - status
+        - is_cancelled
+```
+</File>
+
+To select from this snapshot in a downstream model: `select * from {{ source('jaffle_shop', 'orders') }}`
+</VersionBlock>
+
+<VersionBlock lastVersion="1.8">
+
+
 ```sql
 {% snapshot orders_snapshot_check %}
 
@@ -58,8 +107,32 @@ No default is provided.
 {% endsnapshot %}
 ```
 
+</VersionBlock>
+
 ### Check all columns for changes
 
+<VersionBlock firstVersion="1.9">
+
+<File name="orders_snapshot_check.yml">
+
+```yaml
+snapshots:
+  - name: orders_snapshot_check
+    relation: source('jaffle_shop', 'orders')
+    config:
+      schema: snapshots
+      unique_key: id
+      strategy: check
+      check_cols:
+        - all
+  ```
+</File>
+
+To select from this snapshot in a downstream model: `select * from {{ source('jaffle_shop', 'orders') }}`
+</VersionBlock>
+
+<VersionBlock lastVersion="1.8">
+
 ```sql
 {% snapshot orders_snapshot_check %}
 
@@ -75,3 +148,4 @@ No default is provided.
 
 {% endsnapshot %}
 ```
+</VersionBlock>
diff --git a/website/docs/reference/resource-configs/invalidate_hard_deletes.md b/website/docs/reference/resource-configs/invalidate_hard_deletes.md
index ba5b37c5d71..94fa40ade9d 100644
--- a/website/docs/reference/resource-configs/invalidate_hard_deletes.md
+++ b/website/docs/reference/resource-configs/invalidate_hard_deletes.md
@@ -4,6 +4,32 @@ description: "Invalidate_hard_deletes - Read this in-depth guide to learn about
 datatype: column_name
 ---
 
+
+<VersionBlock firstVersion="1.9">
+
+<File name='snapshots/<filename>.yml'>
+
+```yaml
+snapshots:
+  - name: snapshot
+    relation: source('my_source', 'my_table')
+    [config](/reference/snapshot-configs):
+      strategy: timestamp
+      invalidate_hard_deletes: true | false
+```
+
+</File>
+
+
+</VersionBlock>
+
+<VersionBlock lastVersion="1.8">
+
+:::info Use the latest snapshot syntax
+
+In Versionless and dbt v1.9 and later, snapshots are defined in an updated syntax using a YAML file within your `snapshots/` directory (as defined by the [`snapshot-paths` config](/reference/project-configs/snapshot-paths)). For faster and more efficient management, consider the updated snapshot YAML syntax, [available in Versionless](/docs/dbt-versions/versionless-cloud) or [dbt Core v1.9 and later](/docs/dbt-versions/core).
+:::
+
 <File name='snapshots/<filename>.sql'>
 
 ```jinja2
@@ -17,6 +43,7 @@ datatype: column_name
 ```
 
 </File>
+</VersionBlock>
 
 <File name='dbt_project.yml'>
 
@@ -39,6 +66,26 @@ By default the feature is disabled.
 
 ## Example
 
+<VersionBlock firstVersion="1.9">
+<File name='snapshots/orders.yml'>
+
+```yaml
+snapshots:
+  - name: orders_snapshot
+    relation: source('jaffle_shop', 'orders')
+    config:
+      schema: snapshots
+      database: analytics
+      unique_key: id
+      strategy: timestamp
+      updated_at: updated_at
+      invalidate_hard_deletes: true
+  ```
+</File>
+
+</VersionBlock>
+
+<VersionBlock lastVersion="1.8">
 <File name='snapshots/orders.sql'>
 
 ```sql
@@ -60,3 +107,4 @@ By default the feature is disabled.
 ```
 
 </File>
+</VersionBlock>
diff --git a/website/docs/reference/resource-configs/pre-hook-post-hook.md b/website/docs/reference/resource-configs/pre-hook-post-hook.md
index e1e7d67f02e..cde914fd639 100644
--- a/website/docs/reference/resource-configs/pre-hook-post-hook.md
+++ b/website/docs/reference/resource-configs/pre-hook-post-hook.md
@@ -109,6 +109,8 @@ snapshots:
 
 </File>
 
+<VersionBlock lastVersion="1.8">
+
 <File name='snapshots/<filename>.sql'>
 
 ```sql
@@ -125,13 +127,15 @@ select ...
 ```
 
 </File>
+</VersionBlock>
 
 <File name='snapshots/properties.yml'>
 
 ```yml
 snapshots:
   - name: [<snapshot_name>]
-    config:
+  [config](/reference/resource-properties/config):
+      [<snapshot_config>](/reference/snapshot-configs): <config_value>
       [pre_hook](/reference/resource-configs/pre-hook-post-hook): <sql-statement> | [<sql-statement>]
       [post_hook](/reference/resource-configs/pre-hook-post-hook): <sql-statement> | [<sql-statement>]
 ```
diff --git a/website/docs/reference/resource-configs/snapshot_name.md b/website/docs/reference/resource-configs/snapshot_name.md
index bb4826a116b..a3ce6cbd63b 100644
--- a/website/docs/reference/resource-configs/snapshot_name.md
+++ b/website/docs/reference/resource-configs/snapshot_name.md
@@ -2,6 +2,27 @@
 description: "Snapshot-name - Read this in-depth guide to learn about configurations in dbt."
 ---
 
+<VersionBlock firstVersion="1.9">
+<File name='snapshots/<filename>.yml'>
+
+```yaml
+snapshots:
+  - name: snapshot_name
+    relation: source('my_source', 'my_table')
+    config:
+      schema: string
+      database: string
+      unique_key: column_name_or_expression
+      strategy: timestamp | check
+      updated_at: column_name  # Required if strategy is 'timestamp'
+
+```
+
+</File>
+</VersionBlock>
+
+<VersionBlock lastVersion="1.8">
+
 <File name='snapshots/<filename>.sql'>
 
 ```jinja2
@@ -13,9 +34,16 @@ description: "Snapshot-name - Read this in-depth guide to learn about configurat
 
 </File>
 
+:::info Use the latest snapshot syntax
+
+In Versionless and dbt v1.9 and later, snapshots are defined in an updated syntax using a YAML file within your `snapshots/` directory (as defined by the [`snapshot-paths` config](/reference/project-configs/snapshot-paths)). For faster and more efficient management, consider the updated snapshot YAML syntax, [available in Versionless](/docs/dbt-versions/versionless-cloud) or [dbt Core v1.9 and later](/docs/dbt-versions/core).
+:::
+
+</VersionBlock>
+
 ## Description
 
-The name of a snapshot, as defined in the `{% snapshot %}` block header. This name is used when selecting from a snapshot using the [`ref` function](/reference/dbt-jinja-functions/ref)
+The name of a snapshot, which is used when selecting from a snapshot using the [`ref` function](/reference/dbt-jinja-functions/ref)
 
 This name must not conflict with the name of any other "refable" resource (models, seeds, other snapshots) defined in this project or package.
 
@@ -24,6 +52,26 @@ The name does not need to match the file name. As a result, snapshot filenames d
 ## Examples
 ### Name a snapshot `order_snapshot`
 
+<VersionBlock firstVersion="1.9">
+<File name='snapshots/order_snapshot.yml'>
+
+
+```yaml
+snapshots:
+  - name: order_snapshot
+    relation: source('my_source', 'my_table')
+    config:
+      schema: string
+      database: string
+      unique_key: column_name_or_expression
+      strategy: timestamp | check
+      updated_at: column_name  # Required if strategy is 'timestamp'
+```
+</File>
+
+</VersionBlock>
+
+<VersionBlock lastVersion="1.8">
 <File name='snapshots/orders.sql'>
 
 ```jinja2
@@ -35,6 +83,7 @@ The name does not need to match the file name. As a result, snapshot filenames d
 
 </File>
 
+</VersionBlock>
 
 To select from this snapshot in a downstream model:
 
diff --git a/website/docs/reference/resource-configs/strategy.md b/website/docs/reference/resource-configs/strategy.md
index b67feb64fbd..f55b29703f9 100644
--- a/website/docs/reference/resource-configs/strategy.md
+++ b/website/docs/reference/resource-configs/strategy.md
@@ -4,6 +4,14 @@ description: "Strategy - Read this in-depth guide to learn about configurations
 datatype: timestamp | check
 ---
 
+<VersionBlock lastVersion="1.8">
+
+:::info Use the latest snapshot syntax
+
+In Versionless and dbt v1.9 and later, snapshots are defined in an updated syntax using a YAML file within your `snapshots/` directory (as defined by the [`snapshot-paths` config](/reference/project-configs/snapshot-paths)). For faster and more efficient management, consider the updated snapshot YAML syntax, [available in Versionless](/docs/dbt-versions/versionless-cloud) or [dbt Core v1.9 and later](/docs/dbt-versions/core).
+:::
+</VersionBlock>
+
 <Tabs
   defaultValue="timestamp"
   values={[
@@ -13,6 +21,23 @@ datatype: timestamp | check
 }>
 <TabItem value="timestamp">
 
+<VersionBlock firstVersion="1.9">
+
+<File name='snapshots/<filename>.yml'>
+  
+  ```yaml
+  snapshots:
+  - [name: snapshot_name](/reference/resource-configs/snapshot_name):
+    relation: source('my_source', 'my_table')
+    config:
+      strategy: timestamp
+      updated_at: column_name
+  ```
+</File>
+</VersionBlock>
+
+<VersionBlock lastVersion="1.8">
+
 <File name='snapshots/<filename>.sql'>
 
 ```jinja2
@@ -30,6 +55,7 @@ select ...
 ```
 
 </File>
+</VersionBlock>
 
 <File name='dbt_project.yml'>
 
@@ -47,6 +73,23 @@ snapshots:
 
 <TabItem value="check">
 
+<VersionBlock firstVersion="1.9">
+
+<File name='snapshots/<filename>.yml'>
+  
+  ```yaml
+  snapshots:
+  - [name: snapshot_name](/reference/resource-configs/snapshot_name):
+    relation: source('my_source', 'my_table')
+    config:
+      strategy: check
+      check_cols: 
+        - [column_name] | "all"
+  ```
+</File>
+</VersionBlock>
+
+<VersionBlock lastVersion="1.8">
 <File name='snapshots/<filename>.sql'>
 
 ```jinja2
@@ -62,6 +105,7 @@ snapshots:
 ```
 
 </File>
+</VersionBlock>
 
 <File name='dbt_project.yml'>
 
@@ -88,7 +132,25 @@ This is a **required configuration**. There is no default value.
 ## Examples
 ### Use the timestamp strategy
 
+<VersionBlock firstVersion="1.9">
+<File name='snapshots/timestamp_example.yml'>
+
+```yaml
+snapshots:
+  - name: orders_snapshot_timestamp
+    relation: source('jaffle_shop', 'orders')
+    config:
+      schema: snapshots
+      strategy: timestamp
+      unique_key: id
+      updated_at: updated_at
+
+```
+
+</File>
+</VersionBlock>
 
+<VersionBlock lastVersion="1.8">
 <File name='snapshots/timestamp_example.sql'>
 
 ```sql
@@ -109,10 +171,33 @@ This is a **required configuration**. There is no default value.
 ```
 
 </File>
+</VersionBlock>
 
 
 ### Use the check strategy
 
+<VersionBlock firstVersion="1.9">
+<File name='snapshots/check_example.yml'>
+
+```yaml
+# snapshots/check_example.yml
+snapshots:
+  - name: orders_snapshot_check
+    relation: source('jaffle_shop', 'orders')
+    config:
+      schema: snapshots
+      unique_key: id
+      strategy: check
+      check_cols:
+        - status
+        - is_cancelled
+
+```
+</File>
+</VersionBlock>
+
+<VersionBlock lastVersion="1.8">
+
 ```sql
 {% snapshot orders_snapshot_check %}
 
@@ -129,6 +214,7 @@ This is a **required configuration**. There is no default value.
 
 {% endsnapshot %}
 ```
+</VersionBlock>
 
 ### Advanced: define and use custom snapshot strategy
 Behind the scenes, snapshot strategies are implemented as macros, named `snapshot_<strategy>_strategy`
@@ -140,6 +226,24 @@ It's possible to implement your own snapshot strategy by adding a macro with the
 1. Create a macro named `snapshot_timestamp_with_deletes_strategy`. Use the existing code as a guide and adjust as needed.
 2. Use this strategy via the `strategy` configuration:
 
+<VersionBlock firstVersion="1.9">
+<File name='snapshots/<filename>.yml'>
+
+```yaml
+snapshots:
+  - name: my_custom_snapshot
+    relation: source('my_source', 'my_table')
+    config:
+      strategy: timestamp_with_deletes
+      updated_at: updated_at_column
+      unique_key: id
+      schema: snapshots
+```
+</File>
+</VersionBlock>
+
+
+<VersionBlock lastVersion="1.8">
 <File name='snapshots/<filename>.sql'>
 
 ```jinja2
@@ -155,3 +259,4 @@ It's possible to implement your own snapshot strategy by adding a macro with the
 ```
 
 </File>
+</VersionBlock>
diff --git a/website/docs/reference/resource-configs/unique_key.md b/website/docs/reference/resource-configs/unique_key.md
index 9ad3417fd5e..ac2e08ec61a 100644
--- a/website/docs/reference/resource-configs/unique_key.md
+++ b/website/docs/reference/resource-configs/unique_key.md
@@ -4,6 +4,30 @@ description: "Unique_key - Read this in-depth guide to learn about configuration
 datatype: column_name_or_expression
 ---
 
+
+<VersionBlock firstVersion="1.9">
+
+<File name='snapshots/<filename>.yml'>
+
+```yaml
+snapshots:
+  - name: orders_snapshot
+    relation: source('my_source', 'my_table')
+    [config](/reference/snapshot-configs):
+      unique_key: id
+
+```
+
+</File>
+</VersionBlock>
+
+<VersionBlock lastVersion="1.8">
+
+:::info Use the latest snapshot syntax
+
+In Versionless and dbt v1.9 and later, snapshots are defined in an updated syntax using a YAML file within your `snapshots/` directory (as defined by the [`snapshot-paths` config](/reference/project-configs/snapshot-paths)). For faster and more efficient management, consider the updated snapshot YAML syntax, [available in Versionless](/docs/dbt-versions/versionless-cloud) or [dbt Core v1.9 and later](/docs/dbt-versions/core).
+:::
+
 <File name='snapshots/<filename>.sql'>
 
 ```jinja2
@@ -12,8 +36,8 @@ datatype: column_name_or_expression
 ) }}
 
 ```
-
 </File>
+</VersionBlock>
 
 <File name='dbt_project.yml'>
 
@@ -29,6 +53,8 @@ snapshots:
 ## Description
 A column name or expression that is unique for the inputs of a snapshot. dbt uses this to match records between a result set and an existing snapshot, so that changes can be captured correctly.
 
+In Versionless and dbt v1.9 and later, [snapshots](/docs/build/snapshots) are defined and configured in YAML files within your `snapshots/` directory. The `unique_key` is specified within the `config` block of your snapshot YAML file.
+
 :::caution 
 
 Providing a non-unique key will result in unexpected snapshot results. dbt **will not** test the uniqueness of this key, consider [testing](/blog/primary-key-testing#how-to-test-primary-keys-with-dbt) the source data to ensure that this key is indeed unique.
@@ -41,6 +67,26 @@ This is a **required parameter**. No default is provided.
 
 ## Examples
 ### Use an `id` column as a unique key
+
+<VersionBlock firstVersion="1.9">
+
+<File name="snapshots/orders_snapshot.yml">
+
+```yaml
+snapshots:
+  - name: orders_snapshot
+    relation: source('jaffle_shop', 'orders')
+    config:
+      schema: snapshots
+      unique_key: id
+      strategy: timestamp
+      updated_at: updated_at
+
+```
+</File>
+</VersionBlock>
+
+<VersionBlock lastVersion="1.8">
 <File name='snapshots/<filename>.sql'>
 
 ```jinja2
@@ -55,7 +101,9 @@ This is a **required parameter**. No default is provided.
 </File>
 
 You can also write this in yaml. This might be a good idea if multiple snapshots share the same `unique_key` (though we prefer to apply this configuration in a config block, as above).
+</VersionBlock>
 
+You can also specify configurations in your `dbt_project.yml` file if multiple snapshots share the same `unique_key`:
 <File name='dbt_project.yml'>
 
 ```yml
@@ -70,6 +118,25 @@ snapshots:
 ### Use a combination of two columns as a unique key
 This configuration accepts a valid column expression. As such, you can concatenate two columns together as a unique key if required. It's a good idea to use a separator (e.g. `'-'`) to ensure uniqueness.
 
+<VersionBlock firstVersion="1.9">
+
+<File name='snapshots/transaction_items_snapshot.yml'>
+
+```yaml
+snapshots:
+  - name: transaction_items_snapshot
+    relation: source('erp', 'transactions')
+    config:
+      schema: snapshots
+      unique_key: "transaction_id || '-' || line_item_id"
+      strategy: timestamp
+      updated_at: updated_at
+
+```
+</File>
+</VersionBlock>
+
+<VersionBlock lastVersion="1.8">
 
 <File name='snapshots/transaction_items_snapshot.sql'>
 
@@ -93,10 +160,41 @@ from {{ source('erp', 'transactions') }}
 ```
 
 </File>
+</VersionBlock>
 
 Though, it's probably a better idea to construct this column in your query and use that as the `unique_key`:
 
+<VersionBlock firstVersion="1.9">
+
+<File name='snapshots/transaction_items_snapshot.yml'>
+
+```yaml
+snapshots:
+  - name: transaction_items_snapshot
+    relation: {{ ref('transaction_items_ephemeral') }}
+    config:
+      schema: snapshots
+      unique_key: id
+      strategy: timestamp
+      updated_at: updated_at
+
+# models/transaction_items_ephemeral.sql
+{{ config(materialized='ephemeral') }}
+
+select
+  transaction_id || '-' || line_item_id as id,
+  *
+from {{ source('erp', 'transactions') }}
+
+```
+
+</File>
+
+In this example, we create an ephemeral model `transaction_items_ephemeral` that creates the unique key id, and then references it in our snapshot.
+
+</VersionBlock>
 
+<VersionBlock lastVersion="1.8">
 <File name='snapshots/transaction_items_snapshot.sql'>
 
 ```jinja2
@@ -121,3 +219,4 @@ from {{ source('erp', 'transactions') }}
 ```
 
 </File>
+</VersionBlock>
diff --git a/website/docs/reference/resource-configs/updated_at.md b/website/docs/reference/resource-configs/updated_at.md
index c61b04264be..9c15e99c512 100644
--- a/website/docs/reference/resource-configs/updated_at.md
+++ b/website/docs/reference/resource-configs/updated_at.md
@@ -3,6 +3,30 @@ resource_types: [snapshots]
 description: "Updated_at - Read this in-depth guide to learn about configurations in dbt."
 datatype: column_name
 ---
+
+
+<VersionBlock firstVersion="1.9">
+
+<File name="snapshots/snapshots.yml">
+
+```yaml
+snapshots:
+  - name: snapshot
+    relation: source('my_source', 'my_table')
+    [config](/reference/snapshot-configs):
+      strategy: timestamp
+      updated_at: column_name
+```
+</File>
+</VersionBlock>
+
+<VersionBlock lastVersion="1.8">
+
+:::info Use the latest snapshot syntax
+
+In Versionless and dbt v1.9 and later, snapshots are defined in an updated syntax using a YAML file within your `snapshots/` directory (as defined by the [`snapshot-paths` config](/reference/project-configs/snapshot-paths)). For faster and more efficient management, consider the updated snapshot YAML syntax, [available in Versionless](/docs/dbt-versions/versionless-cloud) or [dbt Core v1.9 and later](/docs/dbt-versions/core).
+:::
+
 <File name='snapshots/<filename>.sql'>
 
 ```jinja2
@@ -14,6 +38,7 @@ datatype: column_name
 ```
 
 </File>
+</VersionBlock>
 
 <File name='dbt_project.yml'>
 
@@ -37,7 +62,6 @@ You will get a warning if the data type of the `updated_at` column does not matc
 
 </VersionBlock>
 
-
 ## Description
 A column within the results of your snapshot query that represents when the record row was last updated.
 
@@ -50,6 +74,25 @@ No default is provided.
 ## Examples
 ### Use a column name `updated_at`
 
+<VersionBlock firstVersion="1.9">
+
+<File name="snapshots/orders_snapshot.yml">
+
+```yaml
+snapshots:
+  - name: orders_snapshot
+    relation: source('jaffle_shop', 'orders')
+    config:
+      schema: snapshots
+      unique_key: id
+      strategy: timestamp
+      updated_at: updated_at
+
+```
+</File>
+</VersionBlock>
+
+<VersionBlock lastVersion="1.8">
 <File name='snapshots/orders.sql'>
 
 ```sql
@@ -72,12 +115,55 @@ select * from {{ source('jaffle_shop', 'orders') }}
 ```
 
 </File>
+</VersionBlock>
 
 ### Coalesce two columns to create a reliable `updated_at` column
 Consider a data source that only has an `updated_at` column filled in when a record is updated (so a `null` value indicates that the record hasn't been updated after it was created).
 
 Since the `updated_at` configuration only takes a column name, rather than an expression, you should update your snapshot query to include the coalesced column.
 
+
+<VersionBlock firstVersion="1.9">
+
+1. Create an staging model to perform the transformation.
+   In your `models/` directory, create a SQL file that configures an staging model to coalesce the `updated_at` and `created_at` columns into a new column `updated_at_for_snapshot`.
+
+    <File name='models/staging_orders.sql'>
+
+    ```sql
+    select  * coalesce (updated_at, created_at) as updated_at_for_snapshot
+    from {{ source('jaffle_shop', 'orders') }}
+
+    ```
+    </File>
+
+2. Define the snapshot configuration in a YAML file. 
+   In your `snapshots/` directory, create a YAML file that defines your snapshot and references the `updated_at_for_snapshot` staging model you just created.
+
+    <File name="snapshots/orders_snapshot.yml">
+
+    ```yaml
+    snapshots:
+      - name: orders_snapshot
+        relation: {{ ref('staging_orders') }}
+        config:
+          schema: snapshots
+          unique_key: id
+          strategy: timestamp
+          updated_at: updated_at_for_snapshot
+
+    ```
+    </File>
+
+3. Run `dbt snapshot` to execute the snapshot.
+
+Alternatively, you can also create an ephemeral model to performs the required transformations. Then, you reference this model in your snapshot's `relation` key.
+
+</VersionBlock>
+
+
+<VersionBlock lastVersion="1.8">
+
 <File name='snapshots/orders.sql'>
 
 ```sql
@@ -104,3 +190,4 @@ from {{ source('jaffle_shop', 'orders') }}
 ```
 
 </File>
+</VersionBlock>
diff --git a/website/docs/reference/snapshot-configs.md b/website/docs/reference/snapshot-configs.md
index f7005021940..bda6da5a26e 100644
--- a/website/docs/reference/snapshot-configs.md
+++ b/website/docs/reference/snapshot-configs.md
@@ -323,7 +323,7 @@ The following examples demonstrate how to configure snapshots using the `dbt_pro
     </VersionBlock>
 
     <VersionBlock firstVersion="1.9">
-     <File name='snapshots/postgres_app/your_snapshot_name.yml'>
+     <File name='snapshots/postgres_app/order_snapshot.yml'>
 
     ```yaml
     snapshots:

From b81da1590078beab6235372a4521e04707cfa67b Mon Sep 17 00:00:00 2001
From: Mirna Wong <89008547+mirnawong1@users.noreply.github.com>
Date: Tue, 1 Oct 2024 14:25:42 +0100
Subject: [PATCH 04/23] Update check_cols.md

---
 website/docs/reference/resource-configs/check_cols.md | 11 ++++-------
 1 file changed, 4 insertions(+), 7 deletions(-)

diff --git a/website/docs/reference/resource-configs/check_cols.md b/website/docs/reference/resource-configs/check_cols.md
index b8e7ae8398f..44aeef96c37 100644
--- a/website/docs/reference/resource-configs/check_cols.md
+++ b/website/docs/reference/resource-configs/check_cols.md
@@ -22,12 +22,6 @@ datatype: "[column_name] | all"
 </File>
 </VersionBlock>
 
-<VersionBlock lastVersion="1.8">
-
-:::info Use the latest snapshot syntax
-
-In Versionless and dbt v1.9 and later, snapshots are defined in an updated syntax using a YAML file within your `snapshots/` directory (as defined by the [`snapshot-paths` config](/reference/project-configs/snapshot-paths)). For faster and more efficient management, consider the updated snapshot YAML syntax, [available in Versionless](/docs/dbt-versions/versionless-cloud) or [dbt Core v1.9 and later](/docs/dbt-versions/core).
-:::
 <File name='snapshots/<filename>.sql'>
 
 ```jinja2
@@ -39,7 +33,6 @@ In Versionless and dbt v1.9 and later, snapshots are defined in an updated synta
 ```
 
 </File>
-</VersionBlock>
 
 <File name='dbt_project.yml'>
 
@@ -90,6 +83,10 @@ To select from this snapshot in a downstream model: `select * from {{ source('ja
 
 <VersionBlock lastVersion="1.8">
 
+:::info Use the latest snapshot syntax
+
+In Versionless and dbt v1.9 and later, snapshots are defined in an updated syntax using a YAML file within your `snapshots/` directory (as defined by the [`snapshot-paths` config](/reference/project-configs/snapshot-paths)). For faster and more efficient management, consider the updated snapshot YAML syntax, [available in Versionless](/docs/dbt-versions/versionless-cloud) or [dbt Core v1.9 and later](/docs/dbt-versions/core).
+:::
 
 ```sql
 {% snapshot orders_snapshot_check %}

From dc6b25e1bb6e5c8d543e84e16d629f24c3199c35 Mon Sep 17 00:00:00 2001
From: Mirna Wong <89008547+mirnawong1@users.noreply.github.com>
Date: Tue, 1 Oct 2024 14:35:50 +0100
Subject: [PATCH 05/23] Update check_cols.md

---
 .../docs/reference/resource-configs/check_cols.md   | 13 ++++++++-----
 1 file changed, 8 insertions(+), 5 deletions(-)

diff --git a/website/docs/reference/resource-configs/check_cols.md b/website/docs/reference/resource-configs/check_cols.md
index 44aeef96c37..8a44c58a26a 100644
--- a/website/docs/reference/resource-configs/check_cols.md
+++ b/website/docs/reference/resource-configs/check_cols.md
@@ -22,6 +22,13 @@ datatype: "[column_name] | all"
 </File>
 </VersionBlock>
 
+<VersionBlock lastVersion="1.8"
+
+:::info Use the latest snapshot syntax
+
+In Versionless and dbt v1.9 and later, snapshots are defined in an updated syntax using a YAML file within your `snapshots/` directory (as defined by the [`snapshot-paths` config](/reference/project-configs/snapshot-paths)). For faster and more efficient management, consider the updated snapshot YAML syntax, [available in Versionless](/docs/dbt-versions/versionless-cloud) or [dbt Core v1.9 and later](/docs/dbt-versions/core).
+:::
+
 <File name='snapshots/<filename>.sql'>
 
 ```jinja2
@@ -33,6 +40,7 @@ datatype: "[column_name] | all"
 ```
 
 </File>
+</VersionBlock>
 
 <File name='dbt_project.yml'>
 
@@ -83,11 +91,6 @@ To select from this snapshot in a downstream model: `select * from {{ source('ja
 
 <VersionBlock lastVersion="1.8">
 
-:::info Use the latest snapshot syntax
-
-In Versionless and dbt v1.9 and later, snapshots are defined in an updated syntax using a YAML file within your `snapshots/` directory (as defined by the [`snapshot-paths` config](/reference/project-configs/snapshot-paths)). For faster and more efficient management, consider the updated snapshot YAML syntax, [available in Versionless](/docs/dbt-versions/versionless-cloud) or [dbt Core v1.9 and later](/docs/dbt-versions/core).
-:::
-
 ```sql
 {% snapshot orders_snapshot_check %}
 

From 966cf41cd7ed103216b54a3b5f0262d696b3e215 Mon Sep 17 00:00:00 2001
From: Mirna Wong <89008547+mirnawong1@users.noreply.github.com>
Date: Tue, 1 Oct 2024 14:45:11 +0100
Subject: [PATCH 06/23] Update check_cols.md

---
 website/docs/reference/resource-configs/check_cols.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/website/docs/reference/resource-configs/check_cols.md b/website/docs/reference/resource-configs/check_cols.md
index 8a44c58a26a..f1fa75d6a46 100644
--- a/website/docs/reference/resource-configs/check_cols.md
+++ b/website/docs/reference/resource-configs/check_cols.md
@@ -22,7 +22,7 @@ datatype: "[column_name] | all"
 </File>
 </VersionBlock>
 
-<VersionBlock lastVersion="1.8"
+<VersionBlock lastVersion="1.8">
 
 :::info Use the latest snapshot syntax
 

From 78706d6ffc06534612a7de5b209927f2a49f7563 Mon Sep 17 00:00:00 2001
From: Mirna Wong <89008547+mirnawong1@users.noreply.github.com>
Date: Tue, 1 Oct 2024 14:53:58 +0100
Subject: [PATCH 07/23] Update pre-hook-post-hook.md

fix spacing
---
 website/docs/reference/resource-configs/pre-hook-post-hook.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/website/docs/reference/resource-configs/pre-hook-post-hook.md b/website/docs/reference/resource-configs/pre-hook-post-hook.md
index cde914fd639..36964538191 100644
--- a/website/docs/reference/resource-configs/pre-hook-post-hook.md
+++ b/website/docs/reference/resource-configs/pre-hook-post-hook.md
@@ -134,7 +134,7 @@ select ...
 ```yml
 snapshots:
   - name: [<snapshot_name>]
-  [config](/reference/resource-properties/config):
+    [config](/reference/resource-properties/config):
       [<snapshot_config>](/reference/snapshot-configs): <config_value>
       [pre_hook](/reference/resource-configs/pre-hook-post-hook): <sql-statement> | [<sql-statement>]
       [post_hook](/reference/resource-configs/pre-hook-post-hook): <sql-statement> | [<sql-statement>]

From d93d65a8115ae52ca9e21f462d939fee8497d2a9 Mon Sep 17 00:00:00 2001
From: Mirna Wong <89008547+mirnawong1@users.noreply.github.com>
Date: Tue, 1 Oct 2024 18:02:09 +0100
Subject: [PATCH 08/23] Update website/docs/reference/snapshot-configs.md

Co-authored-by: Doug Beatty <44704949+dbeatty10@users.noreply.github.com>
---
 website/docs/reference/snapshot-configs.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/website/docs/reference/snapshot-configs.md b/website/docs/reference/snapshot-configs.md
index bda6da5a26e..3cff857d1b6 100644
--- a/website/docs/reference/snapshot-configs.md
+++ b/website/docs/reference/snapshot-configs.md
@@ -255,7 +255,7 @@ snapshots:
 
 
 ## Configuring snapshots
-Snapshots can be configured in one of three ways:
+Snapshots can be configured in multiple ways:
 
 1. Defined in YAML files, typically in your snapshots directory (available in [Versionless](/docs/dbt-versions/versionless-cloud) or and dbt Core v1.9 and higher).
 2. Using a `config` block within a snapshot

From 5ef956ada2e50fce98d145e880336c857cffd970 Mon Sep 17 00:00:00 2001
From: Mirna Wong <89008547+mirnawong1@users.noreply.github.com>
Date: Tue, 1 Oct 2024 18:04:08 +0100
Subject: [PATCH 09/23] Update website/docs/reference/snapshot-configs.md

---
 website/docs/reference/snapshot-configs.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/website/docs/reference/snapshot-configs.md b/website/docs/reference/snapshot-configs.md
index 3cff857d1b6..179c1d52aed 100644
--- a/website/docs/reference/snapshot-configs.md
+++ b/website/docs/reference/snapshot-configs.md
@@ -257,7 +257,7 @@ snapshots:
 ## Configuring snapshots
 Snapshots can be configured in multiple ways:
 
-1. Defined in YAML files, typically in your snapshots directory (available in [Versionless](/docs/dbt-versions/versionless-cloud) or and dbt Core v1.9 and higher).
+1. Defined in YAML files, typically in your [snapshots directory](/reference/project-configs/snapshot-paths) (available in [Versionless](/docs/dbt-versions/versionless-cloud) or and dbt Core v1.9 and higher).
 2. Using a `config` block within a snapshot
 3. Using a `config` [resource property](/reference/model-properties) in a `.yml` file
 4. From the `dbt_project.yml` file, under the `snapshots:` key. To apply a configuration to a snapshot, or directory of snapshots, define the resource path as nested dictionary keys.

From 7f600bac72660d0e948a43204d01599c5a288fc3 Mon Sep 17 00:00:00 2001
From: mirnawong1 <mirnawong@gmail.com>
Date: Tue, 1 Oct 2024 20:15:53 +0100
Subject: [PATCH 10/23] update and triple check

---
 .../docs/reference/configs-and-properties.md  |  4 +-
 .../project-configs/snapshot-paths.md         | 11 ++-
 .../reference/resource-configs/check_cols.md  |  2 +-
 .../reference/resource-configs/strategy.md    |  1 -
 website/docs/reference/snapshot-configs.md    | 73 ++++++++++++-------
 website/docs/reference/snapshot-properties.md |  2 +
 6 files changed, 60 insertions(+), 33 deletions(-)

diff --git a/website/docs/reference/configs-and-properties.md b/website/docs/reference/configs-and-properties.md
index b3f23584a4a..20892898a51 100644
--- a/website/docs/reference/configs-and-properties.md
+++ b/website/docs/reference/configs-and-properties.md
@@ -28,14 +28,14 @@ Depending on the resource type, configurations can be defined in the dbt project
 
 <VersionBlock firstVersion="1.9">
 
-1. Using a [`config` property](/reference/resource-properties/config) in a `.yml` file in the `models/`, `snapshots/`, or `tests/` directory
+1. Using a [`config` property](/reference/resource-properties/config) in a `.yml` file in the `models/`, `snapshots/`, `seeds/`, `analyses`, or `tests/` directory
 2. From the [`dbt_project.yml` file](dbt_project.yml), under the corresponding resource key (`models:`, `snapshots:`, `tests:`, etc)
 </VersionBlock>
 
 <VersionBlock lastVersion="1.8">
 
 1. Using a [`config()` Jinja macro](/reference/dbt-jinja-functions/config) within a `model`, `snapshot`, or `test` SQL file
-2. Using a [`config` property](/reference/resource-properties/config) in a `.yml` file in the `models/`, `snapshots/`, or `tests/` directory.
+2. Using a [`config` property](/reference/resource-properties/config) in a `.yml` file in the `models/`, `snapshots/`, `seeds/`, `analyses/`, or `tests/` directory.
 3. From the [`dbt_project.yml` file](dbt_project.yml), under the corresponding resource key (`models:`, `snapshots:`, `tests:`, etc)
 </VersionBlock>
 
diff --git a/website/docs/reference/project-configs/snapshot-paths.md b/website/docs/reference/project-configs/snapshot-paths.md
index 81b2759609d..8319833f1e6 100644
--- a/website/docs/reference/project-configs/snapshot-paths.md
+++ b/website/docs/reference/project-configs/snapshot-paths.md
@@ -12,7 +12,16 @@ snapshot-paths: [directorypath]
 </File>
 
 ## Definition
-Optionally specify a custom list of directories where [snapshots](/docs/build/snapshots) are located. Note that you cannot co-locate models and snapshots.
+
+Optionally specify a custom list of directories where [snapshots](/docs/build/snapshots) are located. 
+
+<VersionBlock firstVersion="1.9">
+In [Versionless](/docs/dbt-versions/versionless-cloud) and on dbt v1.9 and higher, you can co-locate your snapshots with models if they are [defined using the latest YAML syntax](/docs/build/snapshots). 
+</VersionBlock>
+
+<VersionBlock lastVersion="1.8">
+Note that you cannot co-locate models and snapshots. However, in [Versionless](/docs/dbt-versions/versionless-cloud) and on dbt v1.9 and higher, you can co-locate your snapshots with models if they are [defined using the latest YAML syntax](/docs/build/snapshots).
+</VersionBlock>
 
 ## Default
 By default, dbt will search for snapshots in the `snapshots` directory, i.e. `snapshot-paths: ["snapshots"]`
diff --git a/website/docs/reference/resource-configs/check_cols.md b/website/docs/reference/resource-configs/check_cols.md
index f1fa75d6a46..b9be47fc2f7 100644
--- a/website/docs/reference/resource-configs/check_cols.md
+++ b/website/docs/reference/resource-configs/check_cols.md
@@ -10,7 +10,7 @@ datatype: "[column_name] | all"
   ```yml
   snapshots:
   - name: snapshot_name
-    relation: source('jaffle_shop', 'orders')
+    relation: source('my_source', 'my_table')
     config:
       schema: string
       unique_key: column_name_or_expression
diff --git a/website/docs/reference/resource-configs/strategy.md b/website/docs/reference/resource-configs/strategy.md
index f55b29703f9..1aa06a29fab 100644
--- a/website/docs/reference/resource-configs/strategy.md
+++ b/website/docs/reference/resource-configs/strategy.md
@@ -237,7 +237,6 @@ snapshots:
       strategy: timestamp_with_deletes
       updated_at: updated_at_column
       unique_key: id
-      schema: snapshots
 ```
 </File>
 </VersionBlock>
diff --git a/website/docs/reference/snapshot-configs.md b/website/docs/reference/snapshot-configs.md
index 179c1d52aed..98843c01dac 100644
--- a/website/docs/reference/snapshot-configs.md
+++ b/website/docs/reference/snapshot-configs.md
@@ -23,15 +23,24 @@ Parts of a snapshot:
 
 <ConfigResource meta={frontMatter.meta} />
 
+<VersionBlock lastVersion="1.8">
+
+:::info Use the latest snapshot syntax
+
+In Versionless and dbt v1.9 and later, snapshots are defined in an updated syntax using a YAML file within your `snapshots/` directory (as defined by the [`snapshot-paths` config](/reference/project-configs/snapshot-paths)). For faster and more efficient management, consider the updated snapshot YAML syntax, [available in Versionless](/docs/dbt-versions/versionless-cloud) or [dbt Core v1.9 and later](/docs/dbt-versions/core).
+:::
+</VersionBlock>
+
 <Tabs
   groupId="config-languages"
   defaultValue="project-yaml"
   values={[
     { label: 'Project file', value: 'project-yaml', },
-    { label: 'Property file', value: 'property-yaml', },
-    { label: 'Config block', value: 'config', },
+    { label: 'YAML file', value: 'property-yaml', },
+    { label: 'Config block', value: 'config-resource', },
   ]
 }>
+
 <TabItem value="project-yaml">
 
 <VersionBlock lastVersion="1.8">
@@ -83,7 +92,7 @@ snapshots:
 
 **Note:** Required snapshot properties _will not_ work when defined in `config` YAML blocks. We recommend that you define these in `dbt_project.yml` or a `config()` block within the snapshot `.sql` file.
 
-For faster and more efficient management, consider the updated snapshot YAML syntax, [available in Versionless](/docs/dbt-versions/versionless-cloud) or [dbt v1.9 and later](/docs/dbt-versions/core).
+For faster and more efficient management, consider the [updated snapshot YAML syntax](/docs/build/snapshots), [available in Versionless](/docs/dbt-versions/versionless-cloud) or [dbt v1.9 and later](/docs/dbt-versions/core).
 
 </VersionBlock>
 
@@ -111,33 +120,21 @@ snapshots:
 
 </TabItem>
 
-<TabItem value="config">
+<TabItem value="config-resource">
 
-<VersionBlock lastVersion="1.8">
+<VersionBlock firsttVersion="1.9">
 
-```jinja
-
-{{ config(
-    [target_schema](/reference/resource-configs/target_schema)="<string>",
-    [target_database](/reference/resource-configs/target_database)="<string>",
-    [unique_key](/reference/resource-configs/unique_key)="<column_name_or_expression>",
-    [strategy](/reference/resource-configs/strategy)="timestamp" | "check",
-    [updated_at](/reference/resource-configs/updated_at)="<column_name>",
-    [check_cols](/reference/resource-configs/check_cols)=["<column_name>"] | "all"
-) }}
-
-```
+Configurations can be applied to snapshots using the more performant [YAML syntax](/docs/build/snapshots), aavilable in Versionless and dbt v1.9 and higher, in the the `snapshot` directory file.
 
 </VersionBlock>
 
-<VersionBlock firstVersion="1.9">
+<VersionBlock lastVersion="1.8">
 
 ```jinja
 
 {{ config(
-    [schema](/reference/resource-configs/schema)="<string>",
-    [database](/reference/resource-configs/database)="<string>",
-    [alias](/reference/resource-configs/alias)="<string>",
+    [target_schema](/reference/resource-configs/target_schema)="<string>",
+    [target_database](/reference/resource-configs/target_database)="<string>",
     [unique_key](/reference/resource-configs/unique_key)="<column_name_or_expression>",
     [strategy](/reference/resource-configs/strategy)="timestamp" | "check",
     [updated_at](/reference/resource-configs/updated_at)="<column_name>",
@@ -145,7 +142,6 @@ snapshots:
 ) }}
 
 ```
-
 </VersionBlock>
 
 </TabItem>
@@ -162,7 +158,7 @@ snapshots:
   defaultValue="project-yaml"
   values={[
     { label: 'Project file', value: 'project-yaml', },
-    { label: 'Property file', value: 'property-yaml', },
+    { label: 'YAML file', value: 'property-yaml', },
     { label: 'Config block', value: 'config', },
   ]
 }>
@@ -188,6 +184,7 @@ snapshots:
 <TabItem value="property-yaml">
 
 <VersionBlock lastVersion="1.8">
+
 <File name='snapshots/properties.yml'>
 
 ```yaml
@@ -209,6 +206,7 @@ snapshots:
 </VersionBlock>
 
 <VersionBlock firstVersion="1.9">
+
 <File name='snapshots/properties.yml'>
 
 ```yaml
@@ -234,6 +232,13 @@ snapshots:
 
 <TabItem value="config">
 
+<VersionBlock firsttVersion="1.9">
+
+Configurations can be applied to snapshots using the more performant [YAML syntax](/docs/build/snapshots), aavilable in Versionless and dbt v1.9 and higher, in the the `snapshot` directory file.
+
+</VersionBlock>
+
+<VersionBlock lastVersion="1.8">
 
 ```jinja
 
@@ -249,18 +254,30 @@ snapshots:
 
 ```
 
+</VersionBlock>
+
 </TabItem>
 
 </Tabs>
 
-
 ## Configuring snapshots
 Snapshots can be configured in multiple ways:
 
-1. Defined in YAML files, typically in your [snapshots directory](/reference/project-configs/snapshot-paths) (available in [Versionless](/docs/dbt-versions/versionless-cloud) or and dbt Core v1.9 and higher).
+<VersionBlock firstVersion="1.9">
+
+1. Defined in YAML files using a `config` [resource property](/reference/model-properties), typically in your [snapshots directory](/reference/project-configs/snapshot-paths) (available in [Versionless](/docs/dbt-versions/versionless-cloud) or and dbt Core v1.9 and higher).
+2. From the `dbt_project.yml` file, under the `snapshots:` key. To apply a configuration to a snapshot, or directory of snapshots, define the resource path as nested dictionary keys.
+</VersionBlock>
+
+<VersionBlock lastVersion="1.8">
+
+1. Defined in YAML files using a `config` [resource property](/reference/model-properties), typically in your [snapshots directory](/reference/project-configs/snapshot-paths) (available in [Versionless](/docs/dbt-versions/versionless-cloud) or and dbt Core v1.9 and higher).
 2. Using a `config` block within a snapshot
-3. Using a `config` [resource property](/reference/model-properties) in a `.yml` file
-4. From the `dbt_project.yml` file, under the `snapshots:` key. To apply a configuration to a snapshot, or directory of snapshots, define the resource path as nested dictionary keys.
+3. From the `dbt_project.yml` file, under the `snapshots:` key. To apply a configuration to a snapshot, or directory of snapshots, define the resource path as nested dictionary keys.
+
+Note that in Versionless and dbt v1.9 and later, snapshots are defined in an updated syntax using a YAML file within your `snapshots/` directory (as defined by the [`snapshot-paths` config](/reference/project-configs/snapshot-paths)). For faster and more efficient management, consider the updated snapshot YAML syntax, [available in Versionless](/docs/dbt-versions/versionless-cloud) or [dbt Core v1.9 and later](/docs/dbt-versions/core).
+
+</VersionBlock>
 
 Snapshot configurations are applied hierarchically in the order above.
 
@@ -301,7 +318,7 @@ The following examples demonstrate how to configure snapshots using the `dbt_pro
 - #### Apply configurations to one snapshot only
   
   <VersionBlock lastVersion="1.8">
-  We recommend using `config` blocks if you need to apply a configuration to one snapshot only.
+  Use `config` blocks if you need to apply a configuration to one snapshot only. 
 
     <File name='snapshots/postgres_app/orders_snapshot.sql'>
 
diff --git a/website/docs/reference/snapshot-properties.md b/website/docs/reference/snapshot-properties.md
index 54c1083e4b4..d940a9f344c 100644
--- a/website/docs/reference/snapshot-properties.md
+++ b/website/docs/reference/snapshot-properties.md
@@ -15,6 +15,8 @@ Snapshots properties can be declared in `.yml` files in:
 - your `snapshots/` directory (as defined by the [`snapshot-paths` config](/reference/project-configs/snapshot-paths)).
 - your `models/` directory (as defined by the [`model-paths` config](/reference/project-configs/model-paths))
 
+Note, in Versionless and dbt v1.9 and later, snapshots are defined in an updated syntax using a YAML file within your `snapshots/` directory (as defined by the [`snapshot-paths` config](/reference/project-configs/snapshot-paths)). For faster and more efficient management, consider the updated snapshot YAML syntax, [available in Versionless](/docs/dbt-versions/versionless-cloud) or [dbt Core v1.9 and later](/docs/dbt-versions/core).
+
 </VersionBlock>
 
 We recommend that you put them in the `snapshots/` directory. You can name these files `whatever_you_want.yml`, and nest them arbitrarily deeply in subfolders within the `snapshots/` or `models/` directory.

From b9c2937968ceb053920f76d1a89d8df12ea22240 Mon Sep 17 00:00:00 2001
From: mirnawong1 <mirnawong@gmail.com>
Date: Tue, 1 Oct 2024 20:20:03 +0100
Subject: [PATCH 11/23] update

---
 website/docs/reference/resource-configs/pre-hook-post-hook.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/website/docs/reference/resource-configs/pre-hook-post-hook.md b/website/docs/reference/resource-configs/pre-hook-post-hook.md
index 36964538191..4e8e470be54 100644
--- a/website/docs/reference/resource-configs/pre-hook-post-hook.md
+++ b/website/docs/reference/resource-configs/pre-hook-post-hook.md
@@ -129,7 +129,7 @@ select ...
 </File>
 </VersionBlock>
 
-<File name='snapshots/properties.yml'>
+<File name='snapshots/snapshot.yml'>
 
 ```yml
 snapshots:

From 73a13b045e0d52c1f0db1505e317f5845019f094 Mon Sep 17 00:00:00 2001
From: mirnawong1 <mirnawong@gmail.com>
Date: Tue, 1 Oct 2024 20:27:10 +0100
Subject: [PATCH 12/23] update ref to downstream

---
 website/docs/reference/resource-configs/check_cols.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/website/docs/reference/resource-configs/check_cols.md b/website/docs/reference/resource-configs/check_cols.md
index b9be47fc2f7..9230a0b10ed 100644
--- a/website/docs/reference/resource-configs/check_cols.md
+++ b/website/docs/reference/resource-configs/check_cols.md
@@ -86,7 +86,7 @@ snapshots:
 ```
 </File>
 
-To select from this snapshot in a downstream model: `select * from {{ source('jaffle_shop', 'orders') }}`
+To select from this snapshot in a downstream model: `select * from {{ ref('orders_snapshot_check') }}`
 </VersionBlock>
 
 <VersionBlock lastVersion="1.8">
@@ -128,7 +128,7 @@ snapshots:
   ```
 </File>
 
-To select from this snapshot in a downstream model: `select * from {{ source('jaffle_shop', 'orders') }}`
+To select from this snapshot in a downstream model: `select * from {{{ ref('orders_snapshot_check') }}`
 </VersionBlock>
 
 <VersionBlock lastVersion="1.8">

From 98ad8ac3f45783d2f094556ea85bd8fc641d3acb Mon Sep 17 00:00:00 2001
From: Mirna Wong <89008547+mirnawong1@users.noreply.github.com>
Date: Thu, 3 Oct 2024 15:42:49 +0100
Subject: [PATCH 13/23] Update
 website/docs/reference/resource-configs/strategy.md

Co-authored-by: Doug Beatty <44704949+dbeatty10@users.noreply.github.com>
---
 website/docs/reference/resource-configs/strategy.md | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/website/docs/reference/resource-configs/strategy.md b/website/docs/reference/resource-configs/strategy.md
index 1aa06a29fab..daffb4a6eef 100644
--- a/website/docs/reference/resource-configs/strategy.md
+++ b/website/docs/reference/resource-configs/strategy.md
@@ -83,8 +83,7 @@ snapshots:
     relation: source('my_source', 'my_table')
     config:
       strategy: check
-      check_cols: 
-        - [column_name] | "all"
+      check_cols: [column_name] | "all"
   ```
 </File>
 </VersionBlock>

From b0191c6e2212fe0255fccf9981096fa161e6ae38 Mon Sep 17 00:00:00 2001
From: Mirna Wong <89008547+mirnawong1@users.noreply.github.com>
Date: Thu, 3 Oct 2024 15:43:30 +0100
Subject: [PATCH 14/23] Update website/docs/reference/snapshot-configs.md

Co-authored-by: Doug Beatty <44704949+dbeatty10@users.noreply.github.com>
---
 website/docs/reference/snapshot-configs.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/website/docs/reference/snapshot-configs.md b/website/docs/reference/snapshot-configs.md
index 1bd89fc3ff8..1f062a1a8f0 100644
--- a/website/docs/reference/snapshot-configs.md
+++ b/website/docs/reference/snapshot-configs.md
@@ -230,7 +230,7 @@ snapshots:
 
 <TabItem value="config">
 
-<VersionBlock firsttVersion="1.9">
+<VersionBlock firstVersion="1.9">
 
 Configurations can be applied to snapshots using the more performant [YAML syntax](/docs/build/snapshots), aavilable in Versionless and dbt v1.9 and higher, in the the `snapshot` directory file.
 

From 2076f2690ebf5aa12abd2b619e061a1a1aeb0452 Mon Sep 17 00:00:00 2001
From: Mirna Wong <89008547+mirnawong1@users.noreply.github.com>
Date: Thu, 3 Oct 2024 15:44:09 +0100
Subject: [PATCH 15/23] Update
 website/docs/reference/resource-configs/unique_key.md

Co-authored-by: Doug Beatty <44704949+dbeatty10@users.noreply.github.com>
---
 website/docs/reference/resource-configs/unique_key.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/website/docs/reference/resource-configs/unique_key.md b/website/docs/reference/resource-configs/unique_key.md
index ac2e08ec61a..c27ec2edd75 100644
--- a/website/docs/reference/resource-configs/unique_key.md
+++ b/website/docs/reference/resource-configs/unique_key.md
@@ -190,7 +190,7 @@ from {{ source('erp', 'transactions') }}
 
 </File>
 
-In this example, we create an ephemeral model `transaction_items_ephemeral` that creates the unique key id, and then references it in our snapshot.
+In this example, we create an ephemeral model `transaction_items_ephemeral` that creates an `id` column that can be used as the `unique_key` our snapshot configuration.
 
 </VersionBlock>
 

From 18826b78c44cf02dbd2580eba0d740aeea08677c Mon Sep 17 00:00:00 2001
From: Mirna Wong <89008547+mirnawong1@users.noreply.github.com>
Date: Thu, 3 Oct 2024 15:44:44 +0100
Subject: [PATCH 16/23] Update
 website/docs/reference/resource-configs/updated_at.md

Co-authored-by: Doug Beatty <44704949+dbeatty10@users.noreply.github.com>
---
 website/docs/reference/resource-configs/updated_at.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/website/docs/reference/resource-configs/updated_at.md b/website/docs/reference/resource-configs/updated_at.md
index 9c15e99c512..0e6ff7c1c79 100644
--- a/website/docs/reference/resource-configs/updated_at.md
+++ b/website/docs/reference/resource-configs/updated_at.md
@@ -145,7 +145,7 @@ Since the `updated_at` configuration only takes a column name, rather than an ex
     ```yaml
     snapshots:
       - name: orders_snapshot
-        relation: {{ ref('staging_orders') }}
+        relation: ref('staging_orders')
         config:
           schema: snapshots
           unique_key: id

From d99fb72cbb0b953a74444449f2e1460a69d39aed Mon Sep 17 00:00:00 2001
From: Mirna Wong <89008547+mirnawong1@users.noreply.github.com>
Date: Thu, 3 Oct 2024 15:47:19 +0100
Subject: [PATCH 17/23] Update website/docs/reference/snapshot-configs.md

Co-authored-by: Doug Beatty <44704949+dbeatty10@users.noreply.github.com>
---
 website/docs/reference/snapshot-configs.md | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/website/docs/reference/snapshot-configs.md b/website/docs/reference/snapshot-configs.md
index ba924422eb3..f85fad52cb3 100644
--- a/website/docs/reference/snapshot-configs.md
+++ b/website/docs/reference/snapshot-configs.md
@@ -383,10 +383,9 @@ The following examples demonstrate how to configure snapshots using the `dbt_pro
 
     snapshots:
       - name: orders_snapshot
-        config:
-          persist_docs:
-            relation: true
-            columns: true
+        +persist_docs:
+          relation: true
+          columns: true
     ```
 
     </File>

From 23bb87a215f5ce7f2969287a99ed0f7e31b7824a Mon Sep 17 00:00:00 2001
From: Mirna Wong <89008547+mirnawong1@users.noreply.github.com>
Date: Thu, 3 Oct 2024 15:50:16 +0100
Subject: [PATCH 18/23] Update website/docs/reference/snapshot-configs.md

Co-authored-by: Doug Beatty <44704949+dbeatty10@users.noreply.github.com>
---
 website/docs/reference/snapshot-configs.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/website/docs/reference/snapshot-configs.md b/website/docs/reference/snapshot-configs.md
index f85fad52cb3..6e5dcee0443 100644
--- a/website/docs/reference/snapshot-configs.md
+++ b/website/docs/reference/snapshot-configs.md
@@ -277,7 +277,7 @@ Note that in Versionless and dbt v1.9 and later, snapshots are defined in an upd
 
 </VersionBlock>
 
-Snapshot configurations are applied hierarchically in the order above.
+Snapshot configurations are applied hierarchically in the order above with higher taking precedence.
 
 ### Examples
 The following examples demonstrate how to configure snapshots using the `dbt_project.yml` file, a `config` block within a snapshot, and a `.yml` file.

From 2dbdeedc5d8550f934c4dca1c1e3b1607b72e7f5 Mon Sep 17 00:00:00 2001
From: Mirna Wong <89008547+mirnawong1@users.noreply.github.com>
Date: Thu, 3 Oct 2024 15:50:56 +0100
Subject: [PATCH 19/23] Update website/docs/reference/snapshot-configs.md

Co-authored-by: Doug Beatty <44704949+dbeatty10@users.noreply.github.com>
---
 website/docs/reference/snapshot-configs.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/website/docs/reference/snapshot-configs.md b/website/docs/reference/snapshot-configs.md
index 6e5dcee0443..c61a94026cd 100644
--- a/website/docs/reference/snapshot-configs.md
+++ b/website/docs/reference/snapshot-configs.md
@@ -270,7 +270,7 @@ Snapshots can be configured in multiple ways:
 <VersionBlock lastVersion="1.8">
 
 1. Defined in YAML files using a `config` [resource property](/reference/model-properties), typically in your [snapshots directory](/reference/project-configs/snapshot-paths) (available in [Versionless](/docs/dbt-versions/versionless-cloud) or and dbt Core v1.9 and higher).
-2. Using a `config` block within a snapshot
+2. Using a `config` block within a snapshot defined in Jinja SQL
 3. From the `dbt_project.yml` file, under the `snapshots:` key. To apply a configuration to a snapshot, or directory of snapshots, define the resource path as nested dictionary keys.
 
 Note that in Versionless and dbt v1.9 and later, snapshots are defined in an updated syntax using a YAML file within your `snapshots/` directory (as defined by the [`snapshot-paths` config](/reference/project-configs/snapshot-paths)). For faster and more efficient management, consider the updated snapshot YAML syntax, [available in Versionless](/docs/dbt-versions/versionless-cloud) or [dbt Core v1.9 and later](/docs/dbt-versions/core).

From 4882c6682733923cfff7e7d1dde4edd0fd21dbcf Mon Sep 17 00:00:00 2001
From: Mirna Wong <89008547+mirnawong1@users.noreply.github.com>
Date: Thu, 3 Oct 2024 15:51:11 +0100
Subject: [PATCH 20/23] Update website/docs/reference/snapshot-configs.md

Co-authored-by: Doug Beatty <44704949+dbeatty10@users.noreply.github.com>
---
 website/docs/reference/snapshot-configs.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/website/docs/reference/snapshot-configs.md b/website/docs/reference/snapshot-configs.md
index c61a94026cd..559ddc35fac 100644
--- a/website/docs/reference/snapshot-configs.md
+++ b/website/docs/reference/snapshot-configs.md
@@ -232,7 +232,7 @@ snapshots:
 
 <VersionBlock firstVersion="1.9">
 
-Configurations can be applied to snapshots using the more performant [YAML syntax](/docs/build/snapshots), aavilable in Versionless and dbt v1.9 and higher, in the the `snapshot` directory file.
+Configurations can be applied to snapshots using [YAML syntax](/docs/build/snapshots), available in Versionless and dbt v1.9 and higher, in the the `snapshot` directory file.
 
 </VersionBlock>
 

From 7906a09e743202d46faa259005a618416dab9ff4 Mon Sep 17 00:00:00 2001
From: Mirna Wong <89008547+mirnawong1@users.noreply.github.com>
Date: Thu, 3 Oct 2024 15:55:48 +0100
Subject: [PATCH 21/23] Update website/docs/reference/snapshot-configs.md

Co-authored-by: Doug Beatty <44704949+dbeatty10@users.noreply.github.com>
---
 website/docs/reference/snapshot-configs.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/website/docs/reference/snapshot-configs.md b/website/docs/reference/snapshot-configs.md
index 559ddc35fac..ff8d522075e 100644
--- a/website/docs/reference/snapshot-configs.md
+++ b/website/docs/reference/snapshot-configs.md
@@ -120,7 +120,7 @@ snapshots:
 
 <TabItem value="config-resource">
 
-<VersionBlock firsttVersion="1.9">
+<VersionBlock firstVersion="1.9">
 
 Configurations can be applied to snapshots using the more performant [YAML syntax](/docs/build/snapshots), aavilable in Versionless and dbt v1.9 and higher, in the the `snapshot` directory file.
 

From ffc8b3f21577f72e05d3fe796182a22cecae613a Mon Sep 17 00:00:00 2001
From: Mirna Wong <89008547+mirnawong1@users.noreply.github.com>
Date: Thu, 3 Oct 2024 15:56:05 +0100
Subject: [PATCH 22/23] Update website/docs/reference/snapshot-configs.md

Co-authored-by: Doug Beatty <44704949+dbeatty10@users.noreply.github.com>
---
 website/docs/reference/snapshot-configs.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/website/docs/reference/snapshot-configs.md b/website/docs/reference/snapshot-configs.md
index ff8d522075e..fed2441cc69 100644
--- a/website/docs/reference/snapshot-configs.md
+++ b/website/docs/reference/snapshot-configs.md
@@ -122,7 +122,7 @@ snapshots:
 
 <VersionBlock firstVersion="1.9">
 
-Configurations can be applied to snapshots using the more performant [YAML syntax](/docs/build/snapshots), aavilable in Versionless and dbt v1.9 and higher, in the the `snapshot` directory file.
+Configurations can be applied to snapshots using [YAML syntax](/docs/build/snapshots), available in Versionless and dbt v1.9 and higher, in the the `snapshot` directory file.
 
 </VersionBlock>
 

From dfa67f9fbc7d358dc7b272f17e0581bf95daedd5 Mon Sep 17 00:00:00 2001
From: mirnawong1 <mirnawong@gmail.com>
Date: Thu, 3 Oct 2024 16:58:22 +0100
Subject: [PATCH 23/23] doug's feedback

---
 website/docs/reference/resource-configs/check_cols.md |  5 ++---
 .../resource-configs/invalidate_hard_deletes.md       |  5 ++---
 .../reference/resource-configs/pre-hook-post-hook.md  |  1 -
 .../docs/reference/resource-configs/snapshot_name.md  |  5 ++---
 website/docs/reference/resource-configs/strategy.md   |  6 ++----
 website/docs/reference/resource-configs/unique_key.md | 11 +++++++----
 website/docs/reference/resource-configs/updated_at.md |  5 ++---
 website/docs/reference/snapshot-configs.md            |  7 ++++---
 website/snippets/_snapshot-yaml-spec.md               |  4 ++++
 9 files changed, 25 insertions(+), 24 deletions(-)
 create mode 100644 website/snippets/_snapshot-yaml-spec.md

diff --git a/website/docs/reference/resource-configs/check_cols.md b/website/docs/reference/resource-configs/check_cols.md
index 9230a0b10ed..f7c6b85d372 100644
--- a/website/docs/reference/resource-configs/check_cols.md
+++ b/website/docs/reference/resource-configs/check_cols.md
@@ -24,10 +24,9 @@ datatype: "[column_name] | all"
 
 <VersionBlock lastVersion="1.8">
 
-:::info Use the latest snapshot syntax
+import SnapshotYaml from '/snippets/_snapshot-yaml-spec.md';
 
-In Versionless and dbt v1.9 and later, snapshots are defined in an updated syntax using a YAML file within your `snapshots/` directory (as defined by the [`snapshot-paths` config](/reference/project-configs/snapshot-paths)). For faster and more efficient management, consider the updated snapshot YAML syntax, [available in Versionless](/docs/dbt-versions/versionless-cloud) or [dbt Core v1.9 and later](/docs/dbt-versions/core).
-:::
+<SnapshotYaml/>
 
 <File name='snapshots/<filename>.sql'>
 
diff --git a/website/docs/reference/resource-configs/invalidate_hard_deletes.md b/website/docs/reference/resource-configs/invalidate_hard_deletes.md
index 94fa40ade9d..bdaec7e33a9 100644
--- a/website/docs/reference/resource-configs/invalidate_hard_deletes.md
+++ b/website/docs/reference/resource-configs/invalidate_hard_deletes.md
@@ -25,10 +25,9 @@ snapshots:
 
 <VersionBlock lastVersion="1.8">
 
-:::info Use the latest snapshot syntax
+import SnapshotYaml from '/snippets/_snapshot-yaml-spec.md';
 
-In Versionless and dbt v1.9 and later, snapshots are defined in an updated syntax using a YAML file within your `snapshots/` directory (as defined by the [`snapshot-paths` config](/reference/project-configs/snapshot-paths)). For faster and more efficient management, consider the updated snapshot YAML syntax, [available in Versionless](/docs/dbt-versions/versionless-cloud) or [dbt Core v1.9 and later](/docs/dbt-versions/core).
-:::
+<SnapshotYaml/>
 
 <File name='snapshots/<filename>.sql'>
 
diff --git a/website/docs/reference/resource-configs/pre-hook-post-hook.md b/website/docs/reference/resource-configs/pre-hook-post-hook.md
index 4e8e470be54..ce818768134 100644
--- a/website/docs/reference/resource-configs/pre-hook-post-hook.md
+++ b/website/docs/reference/resource-configs/pre-hook-post-hook.md
@@ -135,7 +135,6 @@ select ...
 snapshots:
   - name: [<snapshot_name>]
     [config](/reference/resource-properties/config):
-      [<snapshot_config>](/reference/snapshot-configs): <config_value>
       [pre_hook](/reference/resource-configs/pre-hook-post-hook): <sql-statement> | [<sql-statement>]
       [post_hook](/reference/resource-configs/pre-hook-post-hook): <sql-statement> | [<sql-statement>]
 ```
diff --git a/website/docs/reference/resource-configs/snapshot_name.md b/website/docs/reference/resource-configs/snapshot_name.md
index a3ce6cbd63b..62480ac3f84 100644
--- a/website/docs/reference/resource-configs/snapshot_name.md
+++ b/website/docs/reference/resource-configs/snapshot_name.md
@@ -34,10 +34,9 @@ snapshots:
 
 </File>
 
-:::info Use the latest snapshot syntax
+import SnapshotYaml from '/snippets/_snapshot-yaml-spec.md';
 
-In Versionless and dbt v1.9 and later, snapshots are defined in an updated syntax using a YAML file within your `snapshots/` directory (as defined by the [`snapshot-paths` config](/reference/project-configs/snapshot-paths)). For faster and more efficient management, consider the updated snapshot YAML syntax, [available in Versionless](/docs/dbt-versions/versionless-cloud) or [dbt Core v1.9 and later](/docs/dbt-versions/core).
-:::
+<SnapshotYaml/>
 
 </VersionBlock>
 
diff --git a/website/docs/reference/resource-configs/strategy.md b/website/docs/reference/resource-configs/strategy.md
index daffb4a6eef..e2b2cac1c59 100644
--- a/website/docs/reference/resource-configs/strategy.md
+++ b/website/docs/reference/resource-configs/strategy.md
@@ -6,10 +6,9 @@ datatype: timestamp | check
 
 <VersionBlock lastVersion="1.8">
 
-:::info Use the latest snapshot syntax
+import SnapshotYaml from '/snippets/_snapshot-yaml-spec.md';
 
-In Versionless and dbt v1.9 and later, snapshots are defined in an updated syntax using a YAML file within your `snapshots/` directory (as defined by the [`snapshot-paths` config](/reference/project-configs/snapshot-paths)). For faster and more efficient management, consider the updated snapshot YAML syntax, [available in Versionless](/docs/dbt-versions/versionless-cloud) or [dbt Core v1.9 and later](/docs/dbt-versions/core).
-:::
+<SnapshotYaml/>
 </VersionBlock>
 
 <Tabs
@@ -179,7 +178,6 @@ snapshots:
 <File name='snapshots/check_example.yml'>
 
 ```yaml
-# snapshots/check_example.yml
 snapshots:
   - name: orders_snapshot_check
     relation: source('jaffle_shop', 'orders')
diff --git a/website/docs/reference/resource-configs/unique_key.md b/website/docs/reference/resource-configs/unique_key.md
index c27ec2edd75..996e7148292 100644
--- a/website/docs/reference/resource-configs/unique_key.md
+++ b/website/docs/reference/resource-configs/unique_key.md
@@ -23,10 +23,9 @@ snapshots:
 
 <VersionBlock lastVersion="1.8">
 
-:::info Use the latest snapshot syntax
+import SnapshotYaml from '/snippets/_snapshot-yaml-spec.md';
 
-In Versionless and dbt v1.9 and later, snapshots are defined in an updated syntax using a YAML file within your `snapshots/` directory (as defined by the [`snapshot-paths` config](/reference/project-configs/snapshot-paths)). For faster and more efficient management, consider the updated snapshot YAML syntax, [available in Versionless](/docs/dbt-versions/versionless-cloud) or [dbt Core v1.9 and later](/docs/dbt-versions/core).
-:::
+<SnapshotYaml/>
 
 <File name='snapshots/<filename>.sql'>
 
@@ -177,8 +176,12 @@ snapshots:
       unique_key: id
       strategy: timestamp
       updated_at: updated_at
+```
+</File>
+
+<File name='models/transaction_items_ephemeral.sql'>
 
-# models/transaction_items_ephemeral.sql
+```sql
 {{ config(materialized='ephemeral') }}
 
 select
diff --git a/website/docs/reference/resource-configs/updated_at.md b/website/docs/reference/resource-configs/updated_at.md
index 0e6ff7c1c79..09122859e43 100644
--- a/website/docs/reference/resource-configs/updated_at.md
+++ b/website/docs/reference/resource-configs/updated_at.md
@@ -22,10 +22,9 @@ snapshots:
 
 <VersionBlock lastVersion="1.8">
 
-:::info Use the latest snapshot syntax
+import SnapshotYaml from '/snippets/_snapshot-yaml-spec.md';
 
-In Versionless and dbt v1.9 and later, snapshots are defined in an updated syntax using a YAML file within your `snapshots/` directory (as defined by the [`snapshot-paths` config](/reference/project-configs/snapshot-paths)). For faster and more efficient management, consider the updated snapshot YAML syntax, [available in Versionless](/docs/dbt-versions/versionless-cloud) or [dbt Core v1.9 and later](/docs/dbt-versions/core).
-:::
+<SnapshotYaml/>
 
 <File name='snapshots/<filename>.sql'>
 
diff --git a/website/docs/reference/snapshot-configs.md b/website/docs/reference/snapshot-configs.md
index fed2441cc69..87063ce592e 100644
--- a/website/docs/reference/snapshot-configs.md
+++ b/website/docs/reference/snapshot-configs.md
@@ -20,15 +20,16 @@ Parts of a snapshot:
 -->
 
 ## Available configurations
+### Snapshot-specific configurations
 
 <ConfigResource meta={frontMatter.meta} />
 
 <VersionBlock lastVersion="1.8">
 
-:::info Use the latest snapshot syntax
+import SnapshotYaml from '/snippets/_snapshot-yaml-spec.md';
+
+<SnapshotYaml/>
 
-In Versionless and dbt v1.9 and later, snapshots are defined in an updated syntax using a YAML file within your `snapshots/` directory (as defined by the [`snapshot-paths` config](/reference/project-configs/snapshot-paths)). For faster and more efficient management, consider the updated snapshot YAML syntax, [available in Versionless](/docs/dbt-versions/versionless-cloud) or [dbt Core v1.9 and later](/docs/dbt-versions/core).
-:::
 </VersionBlock>
 
 <Tabs
diff --git a/website/snippets/_snapshot-yaml-spec.md b/website/snippets/_snapshot-yaml-spec.md
new file mode 100644
index 00000000000..8bbdc6be72e
--- /dev/null
+++ b/website/snippets/_snapshot-yaml-spec.md
@@ -0,0 +1,4 @@
+:::info Use the latest snapshot syntax
+
+In Versionless and dbt v1.9 and later, snapshots are defined in an updated syntax using a YAML file within your `snapshots/` directory (as defined by the [`snapshot-paths` config](/reference/project-configs/snapshot-paths)). For faster and more efficient management, consider the updated snapshot YAML syntax, [available in Versionless](/docs/dbt-versions/versionless-cloud) or [dbt Core v1.9 and later](/docs/dbt-versions/core).
+:::