Skip to main content
XenonStack

Data Science

XenonStack Blog Azure Digital Twins: DTDL, Twin Graph and Fabric

| Published | Updated

Azure Digital Twins: DTDL, Twin Graph and Fabric
9:32

Key takeaway

  • Azure Digital Twins explained: DTDL models, the twin graph, IoT Hub data, Azure Data Explorer history and how it differs from Fabric twin builder.

Azure Digital Twins is a Microsoft platform as a service (PaaS) that builds a live graph of a whole environment, such as a building, factory, energy network or railway, from digital models you define. Each real thing becomes a twin, each twin is an instance of a model, and the relationships between twins form the graph that applications query.

This guide is for enterprise architects and IoT, operations and data leads who need to decide whether a twin graph fits their estate. It explains how models, twins and queries work, how device data flows in and history flows out, how the service differs from device twins and Fabric digital twin builder, and what to do first. For the wider concept, read our guide to digital twin technology.

What is Azure Digital Twins?

The Azure Digital Twins overview describes it as a PaaS offering that enables "the creation of twin graphs based on digital models of entire environments", and it lists buildings, factories, farms, energy networks, railways, stadiums and even entire cities. It lets you connect IoT devices and business systems, run a query API against the live graph, build 3D visualisations, and query historised data alongside other Azure data, analytics and AI services.

When we read the overview in November 2026 it carried no retirement or deprecation notice. It does flag two items as preview, 3D Scenes Studio and digital twin builder in Fabric, and it states that Azure Digital Twins is a different product from both digital twin builder and the device twins used by IoT Hub.

How do models, twins and the graph work?

Models are written in the Digital Twins Definition Language (DTDL). The models documentation says to think of models as "the nouns in a description of your world", similar to a class in an object-oriented language. A twin is an instance of a model, and relationships between twins form the graph.

ElementWhat it doesNote from the documentation
ModelDefines the data shape for one concept, such as a building or a pumpStored as JSON
PropertyHolds the state of a twinUse properties, not DTDL telemetry, for twin state
RelationshipLinks one twin to anotherCan carry its own properties
ComponentDescribes an integral part that needs no separate identityOnly one level of nesting is allowed

Azure Digital Twins supports DTDL versions 2 and 3, and Microsoft recommends version 3 for its array properties, relaxed version rules, higher inheritance limits and feature extensions. The two versions can be mixed, but a version 2 interface cannot extend a version 3 interface. The Explorer tool fully supports version 2 and only partly supports version 3, so version 3 models must be loaded with the APIs, SDKs or Azure CLI. For industries with a modelling standard, Microsoft suggests starting from an existing ontology instead of designing models from scratch.

How does data get into and out of the twin graph?

According to the overview, IoT Hub connects IoT and IoT Edge devices so that hub-managed devices appear in the twin graph and drive the model. Data can also arrive through REST APIs or connectors such as Logic Apps. Our article on IoT analytics platform architecture covers the device side of that flow.

Two-column diagram. Data in: IoT Hub, REST APIs, Logic Apps, DTDL models. Data out: query API, event routes, data history, query plugin.
DirectionMechanismPurpose
InIoT Hub, REST APIs, Logic Apps connectorKeep twin properties current against the real environment
QueryQuery APIFilter on property values, relationships, relationship properties and model information
Out (events)Event routes to Event Hubs, Event Grid or Service BusSend graph events to custom flows, for example into Azure Data Lake
Out (history)Data history to Azure Data ExplorerHistorise graph updates and query them with the Azure Digital Twins query plugin

How does it differ from device twins and Fabric digital twin builder?

OptionWhat it isWhen to consider it
Azure Digital TwinsPaaS twin graph defined in DTDL, with a query API, event routes and data historyYou need relationships between assets, spaces and processes, and applications that react to graph changes
IoT Hub device twinsThe device-level twin that IoT Hub keeps for a registered deviceDevice state and configuration; Azure Digital Twins can connect to these twins
Digital twin builder in FabricA separate product, marked preview on the overview pageRead its own documentation before choosing it, because it is not the same service
Time series store aloneTelemetry kept in a store such as Azure Data ExplorerRelationships are simple and no graph is needed

Where does a twin graph pay off?

The value comes from relationships: which sensor sits in which room, which machine feeds which line, which asset depends on which supply. Typical starting points include:

  • Manufacturing lines and equipment, as in our IoT data analytics use case and our guide to digital twins in Industry 4.0.
  • Smart buildings, where spaces, floors and equipment are linked so readings can be queried by location.
  • Asset-heavy networks such as energy and rail, where a fault must be traced through dependencies.

If you want design help, our digital twin solutions team covers the modelling and integration work.

When is a twin graph the wrong choice?

Azure Digital Twins asks for real engineering effort: DTDL modelling, event handling and operational ownership of connected Azure services. It is a poor fit when you only need telemetry dashboards, when relationships between assets are flat, or when a lighter option already answers the question. The Explorer and 3D Scenes Studio tools carry preview labels, so confirm their status before you depend on them.

How do AI agents change digital twins?

A twin graph gives an agent the context a raw telemetry feed lacks: what an asset is, what it connects to and what depends on it. That makes the graph a natural input for agents that recommend maintenance or energy decisions. It also means the agent needs governed access, clear limits and a record of why it acted. Running such agents at the edge or across sites calls for NexaStack, XenonStack's inference infrastructure.

What should you do first?

  1. Pick one operational question that depends on relationships, such as which assets to service next.
  2. Model only the entities that question needs, in DTDL version 3, starting from an industry ontology where one exists.
  3. Connect one IoT Hub or business feed and verify the twins update correctly.
  4. Turn on data history to Azure Data Explorer if analysts need past states.
  5. Decide who owns each model and who approves changes before you add sites.

To map one asset or maintenance decision your agents should make, and the context and policy it depends on, book a Context Workshop. See what happens in the workshop.

Looking Ahead: Next Steps for Implementation

Talk to our experts about implementing the Microsoft Azure Digital Twin Platform and discover how industries leverage digital twins to optimize operations. Use real-time data and predictive insights to enhance asset management, streamline workflows, and drive digital transformation. By integrating IoT platforms, Azure Digital Twins helps automate processes, improve efficiency, and boost decision-making across departments, creating smarter, data-driven solutions.

Frequently asked questions

What is Azure Digital Twins used for?

It builds twin graphs from digital models of whole environments, such as buildings, factories, energy networks and railways, so applications can query how things relate and react to changes.

What is DTDL?

DTDL, the Digital Twins Definition Language, is the JSON-like language used to define models. Azure Digital Twins supports versions 2 and 3, and Microsoft recommends version 3.

Is Azure Digital Twins the same as IoT Hub device twins?

No. Microsoft's overview states that Azure Digital Twins is different from the device twins used by IoT Hub, although it can connect to them to send and receive live data.

Is Azure Digital Twins the same as digital twin builder in Fabric?

No. The overview presents digital twin builder in Fabric as a separate product and labels it preview.

How is twin history stored?

The data history feature connects an instance to an Azure Data Explorer cluster so graph updates are historised there and can be queried with the Azure Digital Twins query plugin.

Follow XenonStack on LinkedIn: XenonStack on LinkedIn for new guides on agentic AI, data and platform engineering.

Ready to put AI agents to work? Explore ElixirClaw, the agentic OS platform to build, orchestrate and govern AI agents.

Table of Contents

dr-jagreet-gill

Dr. Jagreet Kaur

Chief AI Officer, XenonStack

LinkedIn profile

Dr. Jagreet Kaur specializing in Generative AI for synthetic data, Conversational AI, and Intelligent Document Processing. With a focus on responsible AI frameworks, compliance, and data governance, she drives innovation and transparency in AI implementation

Get the latest articles in your inbox

Subscribe Now

Interested in solving your challenges with the XenonStack team?
Get Started

Tell us about you and your priorities so we can prepare the right conversation. It takes about 2 minutes.

Please Select your Industry
Banking
Fintech
Payment Providers
Wealth Management
Discrete Manufacturing
Semiconductor
Machinery Manufacturing / Automation
Appliances / Electrical / Electronics
Elevator Manufacturing
Defense & Space Manufacturing
Computers & Electronics / Industrial Machinery
Motor Vehicle Manufacturing
Food and Beverages
Distillery & Wines
Beverages
Shipping
Logistics
Mobility (EV / Public Transport)
Energy & Utilities
Hospitality
Digital Gaming Platforms
SportsTech with AI
Public Safety - Explosives
Public Safety - Firefighting
Public Safety - Surveillance
Public Safety - Others
Media Platforms
City Operations
Airlines & Aviation
Defense Warfare & Drones
Robotics Engineering
Drones Manufacturing
AI Labs for Colleges
AI MSP / Quantum / AGI Institutes
Retail Apparel and Fashion

Continue