diff --git a/docs/docs/reference/olap-engines/duckdb.md b/docs/docs/reference/olap-engines/duckdb.md
index cc7b5c00d1c..2b0b83728d3 100644
--- a/docs/docs/reference/olap-engines/duckdb.md
+++ b/docs/docs/reference/olap-engines/duckdb.md
@@ -25,4 +25,6 @@ Well now you can! For more details, see our page on [Using Multiple OLAP Engines
 
 ## Additional Notes
 
-- For dashboards powered by DuckDB, [measure definitions](/build/dashboards/dashboards.md#measures) are required to follow standard [DuckDB SQL](https://duckdb.org/docs/sql/introduction) syntax.
\ No newline at end of file
+- For dashboards powered by DuckDB, [measure definitions](/build/dashboards/dashboards.md#measures) are required to follow standard [DuckDB SQL](https://duckdb.org/docs/sql/introduction) syntax.
+- Known issue around creating a DuckDB via the UI, you will need to create the YAML file manually.
+- Note that local running instances of DuckDB (outside of the default one) is mainly for development and local use. When uploading to Rill Cloud, it is recommended to use a `source` type instead
\ No newline at end of file
diff --git a/docs/docs/reference/project-files/connectors.md b/docs/docs/reference/project-files/connectors.md
index df8dafb51a7..74791787315 100644
--- a/docs/docs/reference/project-files/connectors.md
+++ b/docs/docs/reference/project-files/connectors.md
@@ -28,7 +28,7 @@ Select + Add -> Data -> Connect an OLAP engine
 
 :::tip A note on OLAP engines
 
-You can have multiple OLAP engines in a single project and have each dashboard run on a different engine using the olap_connector parameter directly on a dashboard.
+You can have multiple OLAP engines in a single project and have each dashboard run on a different engine using the `connector` parameter directly on a dashboard.
 
 :::
 
@@ -48,7 +48,7 @@ You can also connect using a dsn parameter. You cannot use the above parameters
 **`dsn`** - connection string containing all the details above, in a single string. Note that each engine's syntax is slightly different. Please refer to [our documentation](https://docs.rilldata.com/reference/olap-engines/) for further details.
 
 ---
-
+ 
 _Example #1: Connecting to a local running Clickhouse server (no security enabled)_
 ```yaml
 type: connector