# FAQs

**URL:** https://community.embeddable.com/c/faqs/6.md

[Latest](https://community.embeddable.com/latest.md) · [Categories](https://community.embeddable.com/categories.md) · [Tags](https://community.embeddable.com/tags.md)

---

## [How Do I Upgrade from Vanilla Components to Remarkable Pro?](https://community.embeddable.com/t/how-do-i-upgrade-from-vanilla-components-to-remarkable-pro/180)

<div class="topic-metadata">

**Author:** [@Chris-Embeddable](https://community.embeddable.com/u/Chris-Embeddable)\
**Replies:** 0\
**Last updated:** [April 22, 2026, 1:20pm UTC](https://community.embeddable.com/t/how-do-i-upgrade-from-vanilla-components-to-remarkable-pro/180 "2026-04-22T13:20:08Z")

</div>

Great news, we’ve created an entire document that talks you through this process (we’re also happy to help, so don’t hesitate to reach out). You can find the document here: Notion

---

## [Are cancelled queries on dashboard load normal?](https://community.embeddable.com/t/are-cancelled-queries-on-dashboard-load-normal/179)

<div class="topic-metadata">

**Author:** [@ella-embeddable](https://community.embeddable.com/u/ella-embeddable)\
**Replies:** 0\
**Last updated:** [March 26, 2026, 7:27pm UTC](https://community.embeddable.com/t/are-cancelled-queries-on-dashboard-load-normal/179 "2026-03-26T19:27:47Z")

</div>

When your dashboards are loading, sometimes you might see cancelled queries in the network tab, like so: This happens when a component immediately updates variable values after they are rendered and is nothing to wor…

---

## [How to Use Tailwind CSS Inside Embeddable Custom Components (Remarkable)](https://community.embeddable.com/t/how-to-use-tailwind-css-inside-embeddable-custom-components-remarkable/178)

<div class="topic-metadata">

**Author:** [@ella-embeddable](https://community.embeddable.com/u/ella-embeddable)\
**Replies:** 0\
**Last updated:** [March 25, 2026, 11:19am UTC](https://community.embeddable.com/t/how-to-use-tailwind-css-inside-embeddable-custom-components-remarkable/178 "2026-03-25T11:19:13Z")

</div>

Tailwind utility classes don’t apply consistently inside Embeddable components because the embedded experience runs inside a shadow DOM, which blocks external stylesheets from penetrating the component scope. CSS variabl…

---

## [Can I Specify a Workspace to Push To?](https://community.embeddable.com/t/can-i-specify-a-workspace-to-push-to/176)

<div class="topic-metadata">

**Author:** [@Chris-Embeddable](https://community.embeddable.com/u/Chris-Embeddable)\
**Replies:** 0\
**Last updated:** [March 23, 2026, 11:08am UTC](https://community.embeddable.com/t/can-i-specify-a-workspace-to-push-to/176 "2026-03-23T11:08:47Z")

</div>

Yes! There are multiple ways to accomplish this, though all of them rely on the Workspace’s API key. The easiest way is just to add flags to the embeddable:push command, like this: npm run embeddable:push -- --api-key …

---

## [Do I Need To Provide Security Context in the Tokens API?](https://community.embeddable.com/t/do-i-need-to-provide-security-context-in-the-tokens-api/173)

<div class="topic-metadata">

**Author:** [@Chris-Embeddable](https://community.embeddable.com/u/Chris-Embeddable)\
**Replies:** 0\
**Last updated:** [March 6, 2026, 3:55pm UTC](https://community.embeddable.com/t/do-i-need-to-provide-security-context-in-the-tokens-api/173 "2026-03-06T15:55:06Z")

</div>

Technically, yes, securityContext is a required body value when using the tokens API to retrieve a token. Most users do need it, in order to enforce row level security. If row level security is not a concern, or you are …

---

## [FAQ: OR filters (e.g. country = FR OR CA) in Embeddable](https://community.embeddable.com/t/faq-or-filters-e-g-country-fr-or-ca-in-embeddable/172)

<div class="topic-metadata">

**Author:** [@ella-embeddable](https://community.embeddable.com/u/ella-embeddable)\
**Replies:** 0\
**Last updated:** [March 3, 2026, 9:49am UTC](https://community.embeddable.com/t/faq-or-filters-e-g-country-fr-or-ca-in-embeddable/172 "2026-03-03T09:49:56Z")

</div>

Can I build an OR filter like country = 'FR' OR country = 'CA'? Yes — if you pass multiple values to a single filter, Embeddable treats it as an OR (SQL IN). Example (code-based datasets / loadData) loadData({ filter…

---

## [What’s the difference between Embeddable Managed Cube and my own Cube Core / Cube Cloud?](https://community.embeddable.com/t/what-s-the-difference-between-embeddable-managed-cube-and-my-own-cube-core-cube-cloud/171)

<div class="topic-metadata">

**Author:** [@Nauman](https://community.embeddable.com/u/Nauman)\
**Replies:** 0\
**Last updated:** [March 2, 2026, 4:22pm UTC](https://community.embeddable.com/t/what-s-the-difference-between-embeddable-managed-cube-and-my-own-cube-core-cube-cloud/171 "2026-03-02T16:22:20Z")

</div>

What’s the difference between Embeddable Managed Cube and my own Cube Core / Cube Cloud? What are the two ways to use Cube with Embeddable? Embeddable supports two ways of working with Cube: :one: Embeddable Managed Cub…

---

## [How can I sort by days of the week / months of the year in Remarkable?](https://community.embeddable.com/t/how-can-i-sort-by-days-of-the-week-months-of-the-year-in-remarkable/170)

<div class="topic-metadata">

**Author:** [@ella-embeddable](https://community.embeddable.com/u/ella-embeddable)\
**Replies:** 0\
**Last updated:** [February 26, 2026, 10:16am UTC](https://community.embeddable.com/t/how-can-i-sort-by-days-of-the-week-months-of-the-year-in-remarkable/170 "2026-02-26T10:16:36Z")

</div>

How can I sort days of the week in the correct order (Mon–Sun) in a table? If you can’t sort by a field that isn’t displayed, the recommended workaround is to map to a dimension that already includes the sort key. Examp…

---

## [Security Token behaviours](https://community.embeddable.com/t/security-token-behaviours/169)

<div class="topic-metadata">

**Author:** [@ella-embeddable](https://community.embeddable.com/u/ella-embeddable)\
**Replies:** 0\
**Last updated:** [February 25, 2026, 12:54pm UTC](https://community.embeddable.com/t/security-token-behaviours/169 "2026-02-25T12:54:49Z")

</div>

Do you support domain restrictions for tokens? Not currently. At the moment, tokens can be used on any domain. That said, the practical risk is low: Tokens are generated using your API key (which should remain secure…

---

## [How to Connect Embeddable to MySQL Version 8 / 8.4](https://community.embeddable.com/t/how-to-connect-embeddable-to-mysql-version-8-8-4/168)

<div class="topic-metadata">

**Author:** [@Nauman](https://community.embeddable.com/u/Nauman)\
**Replies:** 0\
**Last updated:** [February 23, 2026, 7:18pm UTC](https://community.embeddable.com/t/how-to-connect-embeddable-to-mysql-version-8-8-4/168 "2026-02-23T19:18:54Z")

</div>

When connecting a MySQL 8 or MySQL 8.4 (LTS) database to Embeddable, you may encounter the following error: ER\_NOT\_SUPPORTED\_AUTH\_MODE: Client does not support authentication protocol requested by server This happens b…

---

## [How do I stay up to date with Embeddable Package Updates?](https://community.embeddable.com/t/how-do-i-stay-up-to-date-with-embeddable-package-updates/167)

<div class="topic-metadata">

**Author:** [@Chris-Embeddable](https://community.embeddable.com/u/Chris-Embeddable)\
**Replies:** 0\
**Last updated:** [February 18, 2026, 1:56pm UTC](https://community.embeddable.com/t/how-do-i-stay-up-to-date-with-embeddable-package-updates/167 "2026-02-18T13:56:44Z")

</div>

You can run npm run embeddable:upgrade to get the latest versions of all Embeddable NPM packages, including our SDKs, Remarkable Pro, and Vanilla components. This will update your package.json file automatically, and the…

---

## [Do you have a Figma for the Remarkable components?](https://community.embeddable.com/t/do-you-have-a-figma-for-the-remarkable-components/166)

<div class="topic-metadata">

**Author:** [@ella-embeddable](https://community.embeddable.com/u/ella-embeddable)\
**Replies:** 0\
**Last updated:** [February 9, 2026, 3:44pm UTC](https://community.embeddable.com/t/do-you-have-a-figma-for-the-remarkable-components/166 "2026-02-09T15:44:55Z")

</div>

Yes! You can check it out here: https://www.figma.com/community/file/1581738195673665795

---

## [Can I Track When My Custom Canvas Is Ready?](https://community.embeddable.com/t/can-i-track-when-my-custom-canvas-is-ready/165)

<div class="topic-metadata">

**Author:** [@Chris-Embeddable](https://community.embeddable.com/u/Chris-Embeddable)\
**Replies:** 0\
**Last updated:** [January 23, 2026, 2:44pm UTC](https://community.embeddable.com/t/can-i-track-when-my-custom-canvas-is-ready/165 "2026-01-23T14:44:32Z")

</div>

You absolutely can. We’ve introduced a new event, customCanvasReady, that you can listen for like this: const handleCustomCanvasReady = () =\> { // do whatever you like here } element.addEventListener('customCanvasRead…

---

## [Default Environment and data\_source Behavior](https://community.embeddable.com/t/default-environment-and-data-source-behavior/164)

<div class="topic-metadata">

**Author:** [@Nauman](https://community.embeddable.com/u/Nauman)\
**Replies:** 0\
**Last updated:** [January 19, 2026, 4:00pm UTC](https://community.embeddable.com/t/default-environment-and-data-source-behavior/164 "2026-01-19T16:00:24Z")

</div>

Why does every environment require a default data\_source? Embeddable requires each environment to have a default data\_source due to how the underlying data modelling layer (Cube.js) resolves queries. This is an implement…

---

## [Why can’t I remove a connection from the default environment?](https://community.embeddable.com/t/why-can-t-i-remove-a-connection-from-the-default-environment/163)

<div class="topic-metadata">

**Author:** [@Nauman](https://community.embeddable.com/u/Nauman)\
**Replies:** 0\
**Last updated:** [January 19, 2026, 3:54pm UTC](https://community.embeddable.com/t/why-can-t-i-remove-a-connection-from-the-default-environment/163 "2026-01-19T15:54:44Z")

</div>

The default environment is automatically generated and cannot be modified directly. This is intended behavior. If you need to remove a connection from the default environment, delete the connection itself. When a connec…

---

## [Change to models / components not showing in the Embeddable builder](https://community.embeddable.com/t/change-to-models-components-not-showing-in-the-embeddable-builder/162)

<div class="topic-metadata">

**Author:** [@ella-embeddable](https://community.embeddable.com/u/ella-embeddable)\
**Replies:** 0\
**Last updated:** [January 14, 2026, 2:44pm UTC](https://community.embeddable.com/t/change-to-models-components-not-showing-in-the-embeddable-builder/162 "2026-01-14T14:44:41Z")

</div>

If you have made a change to your models or components and it’s not showing within the Embeddable builder, these are the things to check: Make sure you have re-built your repo after your changes (npm run embeddable:bui…

---

## [Why Won't My Dev Server Work In Brave?](https://community.embeddable.com/t/why-wont-my-dev-server-work-in-brave/161)

<div class="topic-metadata">

**Author:** [@Chris-Embeddable](https://community.embeddable.com/u/Chris-Embeddable)\
**Replies:** 0\
**Last updated:** [January 14, 2026, 11:39am UTC](https://community.embeddable.com/t/why-wont-my-dev-server-work-in-brave/161 "2026-01-14T11:39:00Z")

</div>

By default, Brave not only denies access to Localhost resources, but does not even enable its pop-up asking if you want to grant access or not. If you’re getting “please make sure your dev server is running” errors even …

---

## [How do I pick which Remarkable components to include when publishing to our workspace?](https://community.embeddable.com/t/how-do-i-pick-which-remarkable-components-to-include-when-publishing-to-our-workspace/156)

<div class="topic-metadata">

**Author:** [@ella-embeddable](https://community.embeddable.com/u/ella-embeddable)\
**Replies:** 0\
**Last updated:** [January 9, 2026, 8:37am UTC](https://community.embeddable.com/t/how-do-i-pick-which-remarkable-components-to-include-when-publishing-to-our-workspace/156 "2026-01-09T08:37:08Z")

</div>

You can selectively choose which components are included from the Remarkable Pro chart library to appear in your workspace like so: componentLibraries: \[{ name: '@embeddable.com/remarkable-ui', include: \['BarChart…

---

## [What to Check When Renaming Dimensions or Measures in a Cube Model](https://community.embeddable.com/t/what-to-check-when-renaming-dimensions-or-measures-in-a-cube-model/155)

<div class="topic-metadata">

**Author:** [@Nauman](https://community.embeddable.com/u/Nauman)\
**Replies:** 0\
**Last updated:** [January 8, 2026, 10:57am UTC](https://community.embeddable.com/t/what-to-check-when-renaming-dimensions-or-measures-in-a-cube-model/155 "2026-01-08T10:57:57Z")

</div>

:warning: Important: Prefer title property Over Renaming (Best Practice) If your goal is only to change how a dimension or measure appears to end users, do not rename it. Instead, use the title property. The title prop…

---

## [How can I see the Custom Canvas dashboards my users have created / customised for themselves?](https://community.embeddable.com/t/how-can-i-see-the-custom-canvas-dashboards-my-users-have-created-customised-for-themselves/153)

<div class="topic-metadata">

**Author:** [@ella-embeddable](https://community.embeddable.com/u/ella-embeddable)\
**Replies:** 0\
**Last updated:** [December 11, 2025, 1:15pm UTC](https://community.embeddable.com/t/how-can-i-see-the-custom-canvas-dashboards-my-users-have-created-customised-for-themselves/153 "2025-12-11T13:15:56Z")

</div>

The custom canvas created by a user gets stored against the customCanvasState key that you pass to Tokens API. This is explained in detail here. In order to see the dashboard that a user has created, simply generate a to…

---

## [Caching API Per-Environment Update FAQ](https://community.embeddable.com/t/caching-api-per-environment-update-faq/152)

<div class="topic-metadata">

**Author:** [@ella-embeddable](https://community.embeddable.com/u/ella-embeddable)\
**Replies:** 0\
**Last updated:** [November 27, 2025, 1:57pm UTC](https://community.embeddable.com/t/caching-api-per-environment-update-faq/152 "2025-11-27T13:57:24Z")

</div>

Caching API Per-Environment Update FAQ What’s changing We’ve updated the Caching API to support per-environment management of scheduled refresh contexts. You can now update caching configurations for specific environment…

---

## [Can I Change the Start Day for Weeks?](https://community.embeddable.com/t/can-i-change-the-start-day-for-weeks/151)

<div class="topic-metadata">

**Author:** [@Chris-Embeddable](https://community.embeddable.com/u/Chris-Embeddable)\
**Replies:** 0\
**Last updated:** [October 28, 2025, 2:34pm UTC](https://community.embeddable.com/t/can-i-change-the-start-day-for-weeks/151 "2025-10-28T14:34:55Z")

</div>

We don’t currently support changing the start day for weeks in Embeddable to anything other than Monday, but there is a workaround for it that will allow you and your users to select other options. You can extend the gra…

---

## [Why do I see “This API is disabled for this workspace and external system” when using the Connections API?](https://community.embeddable.com/t/why-do-i-see-this-api-is-disabled-for-this-workspace-and-external-system-when-using-the-connections-api/150)

<div class="topic-metadata">

**Author:** [@Nauman](https://community.embeddable.com/u/Nauman)\
**Replies:** 0\
**Last updated:** [October 14, 2025, 11:07am UTC](https://community.embeddable.com/t/why-do-i-see-this-api-is-disabled-for-this-workspace-and-external-system-when-using-the-connections-api/150 "2025-10-14T11:07:25Z")

</div>

This error means the Connections API is not available for your workspace setup. If you’re using your own Cube instance instead of Embeddable’s hosted cube, you should use the Data Provider API instead. Similarly, if yo…

---

## [Pre-aggregations / Level 2 Caching Update](https://community.embeddable.com/t/pre-aggregations-level-2-caching-update/149)

<div class="topic-metadata">

**Author:** [@ella-embeddable](https://community.embeddable.com/u/ella-embeddable)\
**Replies:** 0\
**Last updated:** [September 29, 2025, 8:41am UTC](https://community.embeddable.com/t/pre-aggregations-level-2-caching-update/149 "2025-09-29T08:41:33Z")

</div>

What’s changing We’ve updated our pre-aggregations set-up to support more functionality: partitioning, incremental, and refreshKeys that you can use in your model. Can I use refresh keys directly in the model? Yes. Yo…

---

## [Why Am I Seeing an Error about "SWC" When I Run \`embeddable:dev\`?](https://community.embeddable.com/t/why-am-i-seeing-an-error-about-swc-when-i-run-embeddable-dev/148)

<div class="topic-metadata">

**Author:** [@Chris-Embeddable](https://community.embeddable.com/u/Chris-Embeddable)\
**Replies:** 0\
**Last updated:** [September 17, 2025, 1:49pm UTC](https://community.embeddable.com/t/why-am-i-seeing-an-error-about-swc-when-i-run-embeddable-dev/148 "2025-09-17T13:49:34Z")

</div>

SWC is a piece of technology used by Embeddable’s core SDK. When the node module for it is installed, it’s supposed to build a binary file, but this file doesn’t always get built reliably. If you run into the error, thes…

---

## [What's the Best Practice for the Automatic Granularity Pickers?](https://community.embeddable.com/t/whats-the-best-practice-for-the-automatic-granularity-pickers/147)

<div class="topic-metadata">

**Author:** [@Chris-Embeddable](https://community.embeddable.com/u/Chris-Embeddable)\
**Replies:** 0\
**Last updated:** [September 10, 2025, 8:22am UTC](https://community.embeddable.com/t/whats-the-best-practice-for-the-automatic-granularity-pickers/147 "2025-09-10T08:22:35Z")

</div>

Whenever you choose a time-series Dimension, a granularity picker also shows up automatically. This behavior is intended to replace the previous need to define a granularity input in your emb.ts file. If you have built c…

---

## [Z-index & Shadow DOM: how stacking works](https://community.embeddable.com/t/z-index-shadow-dom-how-stacking-works/146)

<div class="topic-metadata">

**Author:** [@ella-embeddable](https://community.embeddable.com/u/ella-embeddable)\
**Replies:** 0\
**Last updated:** [August 28, 2025, 5:56pm UTC](https://community.embeddable.com/t/z-index-shadow-dom-how-stacking-works/146 "2025-08-28T17:56:11Z")

</div>

Z-index & Shadow DOM: how stacking works What’s going on? Shadow DOM creates isolated stacking contexts. To ensure overlays (e.g., dropdowns) render above content below them, rows inside our component receive incrementi…

---

## [What Are Best Practices for Running Embeddable In Angular?](https://community.embeddable.com/t/what-are-best-practices-for-running-embeddable-in-angular/145)

<div class="topic-metadata">

**Author:** [@Chris-Embeddable](https://community.embeddable.com/u/Chris-Embeddable)\
**Replies:** 0\
**Last updated:** [August 25, 2025, 3:22pm UTC](https://community.embeddable.com/t/what-are-best-practices-for-running-embeddable-in-angular/145 "2025-08-25T15:22:41Z")

</div>

Getting your Embeddable working in an Angular application is very straightforward, but there are a few small things you need to be aware of! Embedding web components in Angular requires you to include their CUSTOM\_ELEME…

---

## [What is the maximum I can set the refreshKey to for the L1 cache?](https://community.embeddable.com/t/what-is-the-maximum-i-can-set-the-refreshkey-to-for-the-l1-cache/144)

<div class="topic-metadata">

**Author:** [@ella-embeddable](https://community.embeddable.com/u/ella-embeddable)\
**Replies:** 0\
**Last updated:** [August 15, 2025, 10:35am UTC](https://community.embeddable.com/t/what-is-the-maximum-i-can-set-the-refreshkey-to-for-the-l1-cache/144 "2025-08-15T10:35:18Z")

</div>

The maximum you can set the refreshKey for L1 caching is 2 minutes - i.e. the data will be refreshed every 2 minutes.

---

## [How to set up Embeddable in a Yarn/Nx monorepo](https://community.embeddable.com/t/how-to-set-up-embeddable-in-a-yarn-nx-monorepo/143)

<div class="topic-metadata">

**Author:** [@ella-embeddable](https://community.embeddable.com/u/ella-embeddable)\
**Replies:** 0\
**Last updated:** [August 12, 2025, 3:59pm UTC](https://community.embeddable.com/t/how-to-set-up-embeddable-in-a-yarn-nx-monorepo/143 "2025-08-12T15:59:05Z")

</div>

Monorepo baseline (Yarn workspaces + Nx) Your repo uses Yarn workspaces, managed by Nx. All packages extend a root tsconfig.json and target modern ESM: { "compilerOptions": { "target": "ES6", "module"…

[Next page](https://community.embeddable.com/c/faqs/6.md?page=1)
