Add detailed comparison of iframe vs React SDK embedding (#460)

* Add detailed comparison of iframe vs React SDK embedding

Generated-By: mintlify-agent

* Use clearer language for iframe embedding description

Generated-By: mintlify-agent

---------

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>

Author: mintlify[bot]

guides/embedding/how-to-embed-content.mdx

@@ -42,14 +42,33 @@ Chart embedding requires the React SDK. iframe embedding is only available for d
 
 ## How can you embed content?
 
-Lightdash offers two embedding methods:
+Lightdash offers two embedding methods. The choice mainly comes down to what you're embedding and how much customization you need.
 
-**[iframe embedding](/references/iframe-embedding)**: Embed Lightdash **dashboards** using a simple iframe with a JWT in the URL. No special integration required. iframe embedding is only available for dashboards, not charts.
+**[iframe embedding](/references/iframe-embedding)** is simple to set up. You only need to generate a JWT, construct a URL, and add this to an `<iframe>` tag. There are no additional setup requirements and this works anywhere (React, Vue, plain HTML). Note that iframe embedding currently only supports dashboards (chart embedding via iframe is not supported).
 
-**[React SDK](/references/react-sdk)**: Use the `@lightdash/sdk` package for seamless integration in React applications. The React SDK supports both dashboards and charts with additional features like programmatic filters and callbacks.
+**[React SDK](/references/react-sdk)** (`@lightdash/sdk`) is the more powerful option. It supports both dashboards and charts, lets you pass filters programmatically, hook into user interaction callbacks (like when someone navigates to Explore), and apply custom styling to match your app. It requires a React/Next.js app and CORS configuration on the Lightdash instance (Cloud customers need to contact Lightdash to set that up).
 
 Both methods use the same JWT-based authentication and security model.
 
+### Quick comparison
+
+| Feature | iframe | React SDK |
+|---|---|---|
+| Dashboards | ✓ | ✓ |
+| Individual charts | ✗ | ✓ |
+| Setup complexity | Low | Medium |
+| CORS needed | No | Yes |
+| Programmatic filters | Via JWT config | Via SDK `filters` prop |
+| Custom styling | Limited | Full control |
+| Framework requirement | None | React / Next.js |
+
+### Passing filters to embedded dashboards
+
+Both methods support filters, just differently:
+
+- **JWT config** — Set filters in the token payload at embed time. Works for both methods.
+- **React SDK `filters` prop** — Pass them dynamically at runtime. Better if filters need to change based on the logged-in user.
+
 ## Quick start: Embed a dashboard
 
 This quick start will walk you through embedding your first dashboard using an iframe.