diff --git a/docs/deploy-viya.md b/docs/deploy-viya.md
index 27af1aa..eaaf1e6 100644
--- a/docs/deploy-viya.md
+++ b/docs/deploy-viya.md
@@ -175,4 +175,4 @@ It is possible to embed a Data Controller table within SAS Visual Analytics by s
 
 To make the portlet more visually appealing, the Data Controller title bar can be removed by adding `?embed=true` to the URL.  When opening in a new window, the title bar will be gone.
 
-For a deeper VA integration - where report row selections drive filters and column visibility in the Data Controller editor - append `?embed=va` instead.  See the [SAS Visual Analytics Embed](/embed-va/) page for details on filter modes, configuration, and debugging.
+For a deeper VA integration - where report row selections drive filters and column visibility in the Data Controller editor - append `?embed=va` instead.  See the [SAS Visual Analytics Embed](/visualanalytics/) page for details on filter modes, configuration, and debugging.
diff --git a/docs/filter.md b/docs/filter.md
index 1dd2b09..c4c845c 100644
--- a/docs/filter.md
+++ b/docs/filter.md
@@ -7,7 +7,7 @@ og_image:  https://docs.datacontroller.io/img/filter_dynamic_on.png
 
 # Filtering
 
-Data Controller for SAS® enables you to create complex table filters. The "dynamic" setting enables the dropdown values to be pre-filtered by previous filter clauses.  Filtered views are shareable!  They are also used when [embedded in VA.](/embed-va)
+Data Controller for SAS® enables you to create complex table filters. The "dynamic" setting enables the dropdown values to be pre-filtered by previous filter clauses.  Filtered views are shareable!  They are also used when [embedded in VA.](/visualanalytics/)
 
 The clause shown above the grid is the resolved WHERE clause that was applied, so it uses SAS syntax - a date, datetime or time filter reads as a SAS literal, eg `SOME_DATE = '20APR2042'd`, rather than the internal day or second count.
 
diff --git a/docs/img/va-embed-og.png b/docs/img/va-embed-og.png
new file mode 100644
index 0000000..5740af1
Binary files /dev/null and b/docs/img/va-embed-og.png differ
diff --git a/docs/index.md b/docs/index.md
index f3f595a..444669c 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -42,7 +42,7 @@ Data Controller is regularly updated with new features.  If you see something th
 * [Row Level Security](/row-level-security)
 * Excel [formula support](excel)
 * Dynamic [cell dropdown](/dynamic-cell-dropdown)
-* [SAS Visual Analytics embed](/embed-va/) - drive the editor from VA report selections
+* [SAS Visual Analytics embed](/visualanalytics/) - drive the editor from VA report selections
 * Works on ALL flavours of SAS (Base, EBI, Viya)
 
 
diff --git a/docs/embed-va.md b/docs/visualanalytics.md
similarity index 96%
rename from docs/embed-va.md
rename to docs/visualanalytics.md
index da94d4c..4f6e03b 100644
--- a/docs/embed-va.md
+++ b/docs/visualanalytics.md
@@ -1,7 +1,9 @@
 ---
 layout: article
 title: SAS Visual Analytics Embed
-description: Embed the Data Controller editor inside a SAS VA report as a data-driven content object.  Row selections in the VA report drive filters and column visibility in the editor.
+description: Embed the Data Controller editor inside a SAS Visual Analytics report as a data-driven content object, so report selections drive filters and column visibility in the editor.
+og_title: Embedding Data Controller in SAS Visual Analytics
+og_image: https://docs.datacontroller.io/img/va-embed-og.png
 ---
 
 # Embedding inside SAS Visual Analytics
@@ -183,7 +185,7 @@ The mapping lives entirely in the URL of the report object, so the job is to get
 
 The object runs as the person **viewing** the report, using their SAS identity - there is no service account behind it. That person must therefore be a registered Data Controller user: if they are not, DC shows its login card inside the object instead of the editor, which looks like a broken embed rather than a permissions matter.
 
-Register everyone who will open the report before you ship it (Users in DC), and test the report as one of them rather than as the person who built it - the author is usually an administrator, so a report that works for them can fail for everyone else.
+Register everyone who will open the report before you ship it (Users in DC), and test the report as one of them rather than as the person who built it - the author often has elevated permissions, so a report that works for them can fail for everyone else.
 
 ## Debugging
 
diff --git a/mkdocs.yml b/mkdocs.yml
index b94d9f7..4a29f05 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -73,7 +73,7 @@ nav:
     - Selectboxes: dcc-selectbox.md
     - Tables: dcc-tables.md
     - Validations: dcc-validations.md
-    - Visual Analytics: embed-va.md
+    - Visual Analytics: visualanalytics.md
 - Macros: macros.md
 - Installation:
     - System Requirements: dci-requirements.md
@@ -113,6 +113,7 @@ plugins:
       redirect_maps:
           'dci-evaluation.md': 'dci-deploysas9.md'
           'dcu-fileupload.md': 'files.md'
+          'embed-va.md': 'visualanalytics.md'
 
 # Repository
 repo_name: 'dc/docs.datacontroller.io'