Skip to content

Observable notebooks and platform FAQ

NotebooksLearn about notebooks vs. projects

Find answers to many common questions about notebooks and the Observable platform below. Use the navigation in the sidebar to jump to relevant sections.

Working in Observable notebooks

How do I get data into a notebook?

See our collection on Getting data in and out of notebooks to learn how to quickly get data from multiple sources into a notebook.

What JavaScript libraries can I use in Observable notebooks?

Observable's Standard Library makes commonly used libraries for working with and visualizing data available for use by default. You can use thousands of additional open source JavaScript modules in your notebooks with Observable require.

How is Observable JavaScript different from vanilla JavaScript?

JavaScript on Observable is almost—but not entirely—vanilla. For dataflow, Observable needed to change JavaScript in a few ways. Learn about the differences in Observable JavaScript.

How can I set a custom URL for my notebook?

See Setting a notebook's URL.

I deleted a notebook. Can I restore it?

If you've deleted a notebook, you can restore it for up to 30 days. To restore a recently deleted notebook, go to Trash (from your homepage) and choose "Move out of trash" in the menu for any notebooks you want to restore.

Is there a list of keyboard shortcuts?

Yes! Here's a guide to keyboard shortcuts in Observable notebooks.

Security and privacy

See our Security and privacy and Security and data access in Observable documentation.

Can I install Observable for use offline or inside a firewall?

Observable can't be installed, used offline, or inside a firewall. However, you can use Observable for secure and sensitive data work. When you access data from local or cloud files, APIs, or self-hosted databases, your data doesn’t touch Observable’s servers. Read more about Observable's security model.

What is Observable's data security policy?

Observable's security model describes how Observable restricts access to your private information.

Can I securely connect to a database?

Yes. Observable's hosted database clients rely on an HTTPS-to-database proxy, which allows your browser to securely run SQL queries against databases that are accessible from the public internet.

If your database isn't accessible from the public internet, or if you simply don't wish to share any database credentials with Observable, we also provide a database proxy that you can run yourself. By connecting directly from your browser to the proxy, your private notebooks can access databases on private networks or local computers. That traffic never goes over the public internet, and you don't need to trust Observable with any database credentials. Learn more at Self-hosted database proxies and Security and data access in Observable.

Collaboration and sharing

How do I add team members to notebooks?

See our Sharing documentation to learn about adding team members and setting permissions so they can view or edit notebooks with you.

Can I share things I make in Observable notebooks elsewhere?

Yes! You can quickly embed notebook content in another website. Observable notebooks can also be compiled and downloaded as JavaScript modules. Download SVGs or PNGs of your notebook charts using options Cell menu (three vertical dots) at the top left of a cell.

Can I store or use different versions of notebooks?

Observable's built-in version history (accessed by clicking on the History pane icon in the right margin) automatically stores versions of a notebook as you iterate. You can see differences between versions, and even revert back to a previous version, through the history pane. You can use version locking to specify which version of a notebook to import from.

User support and feedback

Where can I ask questions and find answers from other users?

The Observable Community Forum and Community Slack workspace are great places to ask questions and find answers from members of the Observable community.

How can I report a bug or request a feature?

We welcome you to share bug reports, feature requests, and feedback as issues in our public feedback repository on GitHub.

I need to delete my account. Can you help?

See our Deleting your account for information on deleting your account (and what gets removed along with it). If you need help, please send an email to support@observablehq.com.

General questions about Observable

D3 is an open-source JavaScript library for data visualization. Observable is an online platform for writing and publishing data work—including D3 data visualizations built with D3. You can also work with any JavaScript library that runs in the browser in an Observable notebooks.