> For the complete documentation index, see [llms.txt](https://docs.themeware.design/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.themeware.design/additional-features/extensions/product-datasheets.md).

# Product datasheets

You can add product data sheets in PDF format to the product using custom fields in the respective product. The data sheets can be displayed on product pages either in the "Properties" tab or in a separate "Datasheets" tab.

<figure><img src="/files/rBZ1okjt3idzq3wPK6HY" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
**Note:** The datasheets are displayed within the product description if the feature is enabled in the theme configuration, the dedicated datasheet tab is disabled, and at least one datasheet has been assigned using a custom field (Datasheet 1–3).
{% endhint %}

{% hint style="success" %}
**Guide**: You can find a step-by-step guide in the ThemeWare® Wiki: [Providing datasheets as PDF](https://knowledge.themeware.design/knowledge-base/tutorials/product-pages/providing-datasheets)
{% endhint %}

{% hint style="info" %}
**Note:** The tab is displayed if the feature is enabled as a dedicated tab in the theme configuration and at least one datasheet has been assigned using a custom field (Datasheet 1–3).
{% endhint %}

***

## Configuration

### **Theme configuration**

#### Datasheets in the properties tab

1. Go to the "**Product pages**" tab
2. Expand the "**Tab "Description"**" block
3. Scroll to the section "**Datasheets**"
4. Enable the configuration "**Show datasheets**"
5. Optional: Use the "**Show preview**" configuration to control whether the embedded PDF preview is shown in the description tab
6. Save your changes after editing

#### Datasheets in a separate tab

1. Go to the "**Product pages**" tab
2. Expand the "**Tab "Datasheets"**" block
3. Enable the configuration "**Show datasheets**"
4. Save your changes after editing

### Datasheets (Custom fields)

1. Switch via the main navigation to the "**Product managment**" (1) (2) ("Catalogues" => "Products")
2. Choose the product you want to edit (3)
3. Switch to the tab "**Specifications**"
4. Scroll to the section "**Custom fields**"
5. Select the custom field set "Datasheets" of your theme
6. Optional: Enter a description in the custom field "**Datasheets (Text)**"
7. Select a datasheet (PDF file) from your media manager in the custom field "**Datasheet 1-3**"
8. Enter the desired link text in the custom field "**Datasheet 1-3 – Title**"
9. Save your changes

<figure><img src="/files/0nbIbh7zxQhKMvatkBDA" alt=""><figcaption><p>Shopware 6 product managment</p></figcaption></figure>

In the separate datasheets tab, the embedded PDF preview is always displayed. In the description tab, it is only shown if the "Show preview" configuration is enabled. The datasheet download link remains available at all times in both cases.

***

## Custom fields

{% content-ref url="/pages/cU2oqJGOZ2fBICYRS4S7" %}
[Datasheets](/additional-features/custom-fields/products/datasheets.md)
{% endcontent-ref %}

***

## Summary

#### Theme configuration

* Tab "Product pages" => Block "Tab "Description"" => Section "Datasheets" => Show datasheets
* Tab "Product pages" => Block "Tab "Description"" => Section "Datasheets" => Show preview
* Tab "Product pages" => Block "Tab "Datasheets"" => Show datasheets tab

#### Snippets

* `twt.detail.datasheets.link`
  * `%name%` is replaced by the file name.
* `twt.detail.datasheets.fallback`

#### Custom fields

* [Datasheet 1-3](/additional-features/custom-fields/products/datasheets/datasheet-1.md)
* [Datasheet 1-3 – Title](/additional-features/custom-fields/products/datasheets/datasheet-1-title.md)
* [Datasheets (Text)](/additional-features/custom-fields/products/datasheets/datasheets-text.md)

***

## Further information

{% content-ref url="/pages/YJV5dfZykicdWr91ZsFI" %}
[Datasheets tab](/additional-features/extensions/tabs-on-product-pages/datasheets-tab.md)
{% endcontent-ref %}