BLOG · GENERAL · B.250910

General

Blocky supports the Notion Data Sources API

Blocky supports the Notion Data Sources API. Select a data source for new charts and widgets, and migrate widgets built from a database ID in minutes.

Blocky supports the Notion Data Sources API
Cover · B.250910

Blocky now works with Notion data source IDs

Blocky now fully supports the Notion Data Sources API. When you create a chart or widget in Blocky, you select a data source, which is the exact table that you want, instead of only a database. By default, Blocky maps older widgets that you built from a database ID to the first data source in that database. You can migrate them to another data source in minutes.

Notion changed how its API defines and references tables. To match, we updated how Blocky connects to Notion, migrates your widgets, and displays your content. Charts that combine several data sources are coming soon.


What changed in Notion's data model

Notion now treats data sources as the individual tables inside a database. Before, you targeted a database to reach its table. Now you reference a data source ID, which points to one exact table. Pages are still rows, and properties still define the schema. Your workspace keeps working, with clearer boundaries between tables.

Notion's latest API version, 2025-09-03, formalizes this change. It adds endpoints and behaviors for data sources. For developers and integrations like Blocky, that means better schema control and more precise queries.


What changes in Blocky

When you create a new chart or widget, Blocky asks you to select a data source instead of only a database. Your selection stays unambiguous, especially in workspaces where one database now contains several data sources.

By default, Blocky automatically maps older widgets, the ones built from a database ID, to the first data source in that database. If your widget was built from that first source's schema, it works as before. If you need a different source, migrate the widget with a refresh or an edit.


Create a new chart from a Notion data source

  1. Go to Blocky.
  2. Create a new chart or widget.
  3. Connect your Notion account.
  4. When Blocky prompts you, select a data source. You see the exact table that you want instead of only a database.
  5. Pick your fields.
  6. Choose a chart type.
  7. Click Save.
  8. Embed the widget in Notion wherever you need it.

Migrate existing widgets to a data source

You can migrate an older widget in three ways.

Refresh the widget in the Blocky dashboard

  1. In the Blocky dashboard, click the ellipsis on the widget.
  2. Click Refresh.

Blocky remaps the old database ID to the first data source. If that's the table you intended, you're done.

Refresh from Quick Actions in Notion

This option needs a Blocky subscription. Use it when you're already working in Notion.

  1. In Notion, open the widget's Quick Actions menu (the ellipsis).
  2. Choose the refresh option.

Blocky refreshes the widget and migrates it.

Edit and save the widget

  1. Choose Edit.
  2. Review the selected data source. For older widgets, Blocky selects the first data source by default. If you need a different source, pick it from the list and confirm.
  3. Click Save.

Your chart or widget then references the new ID immediately.


Questions and edge cases

What if my database now has multiple data sources?

Blocky maps older widgets to the first data source by default. If that's not the right one, open the widget, pick the correct source, and save. When you create a widget, Blocky asks you to choose a data source, so you won't land on the wrong table again.

Will anything break if I do nothing?

If your widget was built from what is now the first data source, it keeps working. If not, the widget may look wrong when you open it in the editor again, because the schemas differ. Select the correct data source again to fix it.

Also check that your Notion integration still has access to all related resources, especially for relations and rollups.

What if the editor shows an error when I edit a widget?

The editor can show an error when the data source is missing or its schema is different. In that case, use a widget code to move your customizations and settings to a new widget:

  1. Open the widget's ellipsis menu and choose the option to generate a widget code. Blocky copies all the customizations and settings of the widget to your clipboard.
  2. Delete the original widget.
  3. Create a new widget.
  4. Import the code in the editor.

Check Notion permissions if you see partial or empty data

If a chart uses relations to another table, share that related database with your Notion integration. Without access, relation and rollup properties can't resolve, and Blocky shows partial or empty data. Share access in Notion, then refresh the widget.

If you switch workspaces, or rename or move data sources, confirm that the integration is still shared. In Notion, you can move or adjust data sources with Manage data sources in the database menu. Then come back to Blocky and refresh the widget to resync it.


Developer notes: IDs, endpoints, and version changes

Notion deprecated the old List Databases endpoint long ago and removed it in newer API versions. If your scripts used it, the supported path is to use the Search API to discover content, then the database or data source endpoints. For data sources, follow the latest reference.

Updates changed too. To update properties that belong to a data source, use the Update a data source endpoint. Database attributes, such as the title or icon, still use the Update a database endpoint.


Roadmap: multi-source charts and multi-view chart options

The Data Sources API makes multi-source charts possible in Blocky. For example, one chart could combine a "Tasks" data source with a "Projects" data source. We're designing interfaces that let you build a chart's series from several sources without copying and pasting data.

We're also building multi-view chart options, so you can switch the same data between bar, line, and area views. You'll compare views faster and need fewer copies of a chart. If you want a specific combination first, tell us. Your input will shape the rollout.


Notion's Data Source object reference and its Working with databases guide explain the underlying model.


Next steps

  • Create a new chart and select a data source.
  • Refresh older widgets, or use Quick Actions in Notion to migrate them.
  • Check Notion permissions for related databases and rollups.
  • Watch Blocky for multi-source and multi-view chart announcements.
  • Tell us which visualizations should come first.

If you run a team workspace, document the "data source first" approach in your internal playbook and link to Notion's docs, so everyone on the team follows the same approach.



Filed under General

RELATED · 03

Studio · CustomizeLive preview

Compose · Preview · Embed

Customize a widget, then embed it anywhere in Notion

Shape one of Blocky’s 60+ widgets to your data and layout, preview the result live, then drop the embed link into any Notion page. Sign in to start customizing.

Start customizing