diff --git a/README.md b/README.md
index c4a4f8a..effeb27 100644
--- a/README.md
+++ b/README.md
@@ -25,12 +25,14 @@ import formbricks from "@formbricks/js";
 
 if (typeof window !== "undefined") {
   formbricks.setup({
-    environmentId: "your-environment-id",
+    workspaceId: "your-workspace-id",
     appUrl: "https://app.formbricks.com",
   });
 }
 ```
 
-Replace your-environment-id with your actual environment ID. You can find your environment ID in the **Setup Checklist** in the Formbricks settings. If you want to use the user identification feature, please check out [our docs for details](https://formbricks.com/docs/app-surveys/user-identification).
+Replace your-workspace-id with your actual workspace ID. You can find your workspace ID in the **Setup Checklist** in the Formbricks settings. If you want to use the user identification feature, please check out [our docs for details](https://formbricks.com/docs/app-surveys/user-identification).
+
+> `environmentId` is still accepted for backward compatibility but is deprecated and will be removed in a future version. Prefer `workspaceId`.
 
 For more detailed guides for different frameworks, check out our [Framework Guides](https://formbricks.com/docs/getting-started/framework-guides).
diff --git a/apps/playground/.env.example b/apps/playground/.env.example
index 2581d17..eb1614c 100644
--- a/apps/playground/.env.example
+++ b/apps/playground/.env.example
@@ -1,2 +1,2 @@
 VITE_FORMBRICKS_API_HOST=http://localhost:3000
-VITE_FORMBRICKS_ENVIRONMENT_ID=YOUR-ENVIRONMENT-ID
+VITE_FORMBRICKS_WORKSPACE_ID=YOUR-WORKSPACE-ID
diff --git a/apps/playground/README.md b/apps/playground/README.md
index 7becf37..1ce1ed1 100644
--- a/apps/playground/README.md
+++ b/apps/playground/README.md
@@ -13,11 +13,13 @@ pnpm install
 1. Create a `.env` file with your Formbricks credentials:
 
 ```env
-VITE_FORMBRICKS_ENVIRONMENT_ID=your-environment-id
+VITE_FORMBRICKS_WORKSPACE_ID=your-workspace-id
 VITE_FORMBRICKS_API_HOST=https://app.formbricks.com
 ```
 
-You can find your environment ID in the Formbricks app under Settings → Setup.
+Replace your-workspace-id with your actual workspace ID. You can find your workspace ID in the **Connections instructions** in the Formbricks **Configuration** pages.
+
+> `environmentId` / `VITE_FORMBRICKS_ENVIRONMENT_ID` is still accepted for backward compatibility but is deprecated and will be removed in a future version. Prefer `workspaceId`.
 
 1. Start the development server:
 
diff --git a/apps/playground/src/app.tsx b/apps/playground/src/app.tsx
index 314dfc0..ccdd366 100644
--- a/apps/playground/src/app.tsx
+++ b/apps/playground/src/app.tsx
@@ -24,8 +24,8 @@ export default function App(): React.JSX.Element {
     }
 
     const missingEnvVars = [
-      !import.meta.env.VITE_FORMBRICKS_ENVIRONMENT_ID
-        ? "VITE_FORMBRICKS_ENVIRONMENT_ID"
+      !import.meta.env.VITE_FORMBRICKS_WORKSPACE_ID
+        ? "VITE_FORMBRICKS_WORKSPACE_ID"
         : null,
       !import.meta.env.VITE_FORMBRICKS_API_HOST
         ? "VITE_FORMBRICKS_API_HOST"
@@ -34,7 +34,7 @@ export default function App(): React.JSX.Element {
 
     if (missingEnvVars.length === 0) {
       formbricks.setup({
-        environmentId: import.meta.env.VITE_FORMBRICKS_ENVIRONMENT_ID,
+        workspaceId: import.meta.env.VITE_FORMBRICKS_WORKSPACE_ID,
         appUrl: import.meta.env.VITE_FORMBRICKS_API_HOST,
       });
     } else {
@@ -79,11 +79,11 @@ export default function App(): React.JSX.Element {
             <img src={fbsetup} alt="fb setup" className="mt-4 rounded-xs" />
             <div className="mt-4 flex-col items-start text-sm text-slate-700 sm:flex sm:items-center sm:text-base dark:text-slate-300">
               <p className="mb-1 sm:mr-2 sm:mb-0">
-                You&apos;re connected with env:
+                You&apos;re connected with workspace:
               </p>
               <div className="flex items-center">
                 <strong className="w-32 truncate sm:w-auto">
-                  {import.meta.env.VITE_FORMBRICKS_ENVIRONMENT_ID ??
+                  {import.meta.env.VITE_FORMBRICKS_WORKSPACE_ID ??
                     "Not configured"}
                 </strong>
                 <span className="relative ml-2 flex h-3 w-3">
diff --git a/packages/js/package.json b/packages/js/package.json
index 7dd236f..266b200 100644
--- a/packages/js/package.json
+++ b/packages/js/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@formbricks/js",
   "license": "MIT",
-  "version": "4.4.0",
+  "version": "5.0.0",
   "description": "Formbricks-js allows you to connect your index to Formbricks, display surveys and trigger events.",
   "homepage": "https://formbricks.com",
   "repository": {