Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions guides/development/integrations-api/partial-data-loading.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,8 @@ nav:

`Partial data loading` allows you to select specific fields of an entity to be returned by the API. This can be useful if you only need a few fields of an entity and don't want to load the whole entity. This can reduce response size and improve your application's performance.

Shopware itself uses this mechanism for storefront product listings when the `core.listing.partialDataLoading` setting is enabled. See [Reduced product data in listings](../../hosting/performance/performance-tweaks.md#reduced-product-data-in-listings).

## Partial data loading vs Includes

`Partial data loading` is different from the [includes](./search-criteria.md#includes-apialias) feature. The `includes` works as post-output processing, so the complete entity or data is loaded on the backend and then filtered, while `partial data loading` works already at the database level. This means the database only loads the requested fields, not the entire entity.
Expand Down
14 changes: 14 additions & 0 deletions guides/hosting/performance/performance-tweaks.md
Original file line number Diff line number Diff line change
Expand Up @@ -107,6 +107,20 @@ Supported since Shopware `6.7.9.0`. This is an experimental feature. For impleme

Read more on [Elasticsearch setup](../infrastructure/elasticsearch/elasticsearch-setup)

## Reduced product data in listings

Product listings can load a reduced, curated field set instead of full product entities.
This includes the `descriptionTeaser`, a shortened, HTML-free excerpt that replaces the full description in listings.
It lowers database load, memory usage and transfer size — especially for catalogs with large product descriptions.
Comment on lines +112 to +114

Enable the setting per sales channel under *Settings > Products > "Load reduced product data in listings"* (`core.listing.partialDataLoading`).
With the setting enabled, listing products are partial entities — only enable it if your theme and extensions do not require additional product data in listings.
The underlying mechanism is described in [Partial data loading](../../development/integrations-api/partial-data-loading.md).

::: info
Supported since Shopware `6.7.12.0`. Fresh installations start with this setting enabled; existing shops keep the full listing loading until they opt in.
:::

## Prevent mail data updates

To provide auto-completion for different mail templates in the Administration UI, Shopware has a mechanism that writes an example mail into the database when sending the mail.
Expand Down
Loading