M365Con 2027 – free online conference · 11–22 Jan 2027 · 120 sessions m365con.net

Isolated storage

Concept

Business Central data storage for key/value pairs that is isolated per extension, so other extensions cannot read the stored values; often used for secrets in development and test scenarios.

✦ CONCEPTIsolated storageM365.FM
Title graphic: Isolated storage (Concept)

Description

Isolated storage is a data store in Microsoft Dynamics 365 Business Central that keeps extensions separated from each other. An extension saves its values as key-value pairs, and other extensions cannot retrieve those pairs. This separation is the defining property of the concept: whatever one extension writes into isolated storage stays out of reach of every other extension running in the same environment.

Because of that isolation, isolated storage is often used for secrets, particularly in development and test scenarios. Typical examples are values an extension needs to remember but that should not be exposed to unrelated code, such as credentials or tokens used to reach an external service. The documentation itself describes the purpose in general terms, as protecting an extension's values from other extensions, and does not list further usage scenarios.

Access to isolated storage goes through an API exposed as the IsolatedStorage data type in the AL language. The available methods let an extension set a value for a key, read it back, check whether a key exists, and delete it. A developer therefore works with simple key-based operations rather than with tables or records, which keeps the pattern small and easy to apply for configuration-like or sensitive values.

Each of these methods can take a data scope argument, which classifies the stored data. The DataScope option type is named in the documentation as related reference material, alongside the IsolatedStorage data type. Choosing the scope is a design decision, because it determines how the stored value is classified and therefore who it is associated with. The documentation excerpt available here does not spell out the individual scope values, so the AL reference for the DataScope option type is the place to confirm them.

There is also a method that encrypts the value before storing it. This is relevant when the stored value is a secret rather than ordinary configuration. The encrypting method limits the plain-text input to a fixed number of characters, and special characters take up more space than ordinary ones, so longer secrets or values with many special characters need to be planned for. The documentation page does not describe size limits for isolated storage as a whole or how it behaves across environments, so those points should be checked in the official reference before relying on them.

In practice, the decision around isolated storage is whether a value belongs in a regular table or in a store that other extensions cannot read. Values that are sensitive or that must not be visible to other extensions are the natural fit, while shared business data is not. The data scope argument and the choice between plain and encrypted storage are the main levers a developer has.

M365.FM does not cover isolated storage in Business Central directly. The episode "Shared Data Reservoirs for Multi-Tenant Microsoft 365" (2026-05-11) discusses storage in a different sense: it contrasts isolated storage silos and fixed allocations with elastic shared data reservoirs, covering concepts such as Azure Elastic SAN, Azure SQL Hyperscale and elastic storage pools. That discussion concerns cloud storage architecture and capacity planning, not the Business Central AL feature, so the two uses of the word should not be confused.

Overview compiled with AI from M365.FM episodes and the facts on this page. You can improve it with the edit button below.

TypeConcept

Frequently asked questions

Questions marked with AI were written with AI from the facts on this page.

What is isolated storage in Business Central? (AI)

It is a data store that keeps extensions separated from each other. An extension saves key-value pairs in it, and other extensions cannot retrieve those pairs.

How does an extension use isolated storage? (AI)

Through the IsolatedStorage data type in the AL language. Its methods set a value for a key, read it, check whether a key exists, and delete it, and they can take a data scope argument.

Can isolated storage hold encrypted values? (AI)

Yes, there is a method that encrypts the value before storing it. That method limits the plain-text input to a fixed number of characters, and special characters take up more space.

Glossary

Community wiki

Short info above, community knowledge below: add practical tips, examples or corrections. New contributions are reviewed first; trusted members publish directly.

Experts and companies for this topic

Nobody has listed this topic yet. Add it to your profile.

Maintained by Mirko Peters (Microsoft MVP) · Last updated: