Skip to content

The easy-to-use open source Business Intelligence and Embedded Analytics tool that lets everyone work with data :bar_chart:

Revise embedding guide and emphasize user accounts (#64637)

Alex Yarosh9a192e68dec1
diff --git a/docs/embedding/embedded-analytics-js.md b/docs/embedding/embedded-analytics-js.md
index 23974357303..c475609664a 100644
--- a/docs/embedding/embedded-analytics-js.md
+++ b/docs/embedding/embedded-analytics-js.md
@@ -35,7 +35,7 @@ You can also follow the setup guide directly in Metabase in **Admin > Embedding
### 2. Create a new embed
-1. In Metabase, go to **Admin > Embedding > Setup guide > Embed in your code**, and select **Try it out** next to **Embedded analytics JS**.
+1. In Metabase, go to **Admin > Embedding > Modular embedding**, and select **New embed** next to **Embedded analytics JS**.
If you're planning to embed an existing question or dashboard, you can instead go straight to that question or dashboard, click on the **Share** button, and choose **Embedded Analytics JS**.
@@ -74,6 +74,16 @@ Metabase will generate a code snippet that you can copy and paste into your app,
Add the code snippet into your app, and refresh the page.
+## Each end user should have their own Metabase account
+
+Each end-user must have their own Metabase account.
+
+The problem with having end-users share a Metabase account is that, even if you filter data on the client side via the Embedded analytics JS, all end-users will still have access to the session token, which they could use to access Metabase directly via the API to get data they’re not supposed to see.
+
+If each end-user has their own Metabase account, however, you can configure permissions in Metabase and everyone will only have access to the data they should.
+
+In addition to this, we consider shared accounts to be unfair usage. Fair usage of Embedded Analytics JS involves giving each end-user of the embedded analytics their own Metabase account.
+
## Embed code snippets
The code snippets to embed Metabase entities using Embedded Analytics JS should have three parts: