---
title: "Change the Data Model associated with a Capsule"
slug: "change-the-data-model-associated-with-a-capsule"
description: "Learn how to switch the Data Model of a Capsule in Board: reassign Entities, update linked Screens and Objects, maintain consistency and avoid broken references."
tags: ["Capsule", "Developer", "Data Model"]
updated: 2025-10-27T16:31:22Z
published: 2025-10-27T16:31:22Z
canonical: "help.board.com/change-the-data-model-associated-with-a-capsule"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://help.board.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Change the Data Model associated with a Capsule

To change the Data Model associated with a Capsule (i.e. with all Screens of that Capsule):

1. Right-click on the Capsule tile and select "Capsule properties".

![contents/assets/images/capsule.change.data.model.png](https://cdn.document360.io/8d6f1ae8-0cac-4d0d-a208-6245b83df94a/Images/Documentation/change-the-data-model-associated-with-a-capsule-image-v753a2e5.png)
2. In the Capsule properties page, click on "REPLACE DATA MODEL".
3. Fill the "Target Data model" and "New Data model" fields, then click the "REPLACE" button.

*Both fields are case sensitive.*

*Only Data Models that you have been granted access to will be suggested during typing.*
4. Click the "YES, CONFIRM" button.

*If the Capsule contains Screens associated with different Data Models, any association change made in the Capsule properties page will only affect the Screens associated with the replaced Data Model. If the Capsule contains Screens whose Objects are associated with different Data Models, any association change made in the Capsule properties page will only affect the Objects associated with the replaced Data Model.*