---
title: Custom Entities | Shopware Community Hub
description: >-
  Learn how to design, define, and interact with Custom Entities in your
  Shopware App to extend Shopware’s data model without writing PHP migrations.
canonical_url: 'https://hub.shopware.com/learn/course/custom-entities'
---

# Custom Entities

<LearningObjectives>

- **Understand** what **Custom Entities** are and how to use them in Shopware Apps.
- **Define** Custom Entities using the **`entities.xml`** file.
- **Create** and **manage** data records for Custom Entities.
- **Configure** proper **permissions** in the manifest file for Custom Entity **access**.
- **Troubleshoot common issues** with Custom Entity definitions and API interactions.

</LearningObjectives>

# Custom Entities

**Very well that you come this far!** At this point you have learned a lot – from the fundamental of the App System to rendering the storefront asynchronously and synchronously.

In this course, you will learn how to extend Shopware's data model with your own data, without modifying the core or writing PHP migrations.

By the end, you will understand how to design and define **Custom Entities**, how to send and retrieve data through the **Shopware APIs**, and how to integrate your custom data into your App.

## Learning Units

## Units
- [Introduction to Custom Entities](/learn/unit/introduction-to-custom-entities): Learn what Custom Entities are, why they exist, and when to use them to extend the Shopware data model in your App.
- [Defining Custom Entities](/learn/unit/app-defining-custom-entities): Learn how to define Custom Entities in an App with the entities.xml file and extend the Shopware database without writing any PHP code.
- [Sending Data to Custom Entities via the Admin API](/learn/unit/app-uploading-custom-entity-data): Learn how to use the Shopware Admin API to authenticate, locate Custom Entity endpoints, send data records and configure permissions in the manifest.xml file.