> For the complete documentation index, see [llms.txt](https://productattachments.docs.foxnetsoft.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://productattachments.docs.foxnetsoft.com/create-new-attachment.md).

# Create new attachment

## Overview

To create new attachments, navigate to the **Attachments page** of the plugin, and click on **Add new** in top right corner.

You will be redirected to the attachment setup page. This page has two blocks with different settings for your attachments.

{% hint style="warning" %}
You need to fill **Main** block, then click **Save and continue edit**, and then fill **Mappings** block
{% endhint %}

### Main block

<table><thead><tr><th width="180.5">Setting</th><th>Explanation</th></tr></thead><tbody><tr><td>Published</td><td>Whether the attachment is published and displayed in the store</td></tr><tr><td>Associated to</td><td>Attachments can be associated to Products, Categories, or Manufacturers. If an attachment is associated to Categories or Manufacturers, it will be associated to all products in these categories/manufacturers.</td></tr><tr><td>Icon</td><td>What icon to show next to attachment. Note, if your attachment is a YouTube/HTML5 video, an icon will not be shown.</td></tr><tr><td>Attachment type</td><td>The plugin supports 4 attachment types. <br>File<br>URL<br>Embed YouTube<br>HTML5 Video (mp4)</td></tr><tr><td>Attachment parameters</td><td>Every attachment type has their own attachment parameters. Url, Upload file, etc.</td></tr><tr><td>Name</td><td>The display name of the attachment. Note, YouTube and HTML5 videos will be shown without Name, just thunbnail.</td></tr><tr><td>Display Order</td><td>Order in which to display attachments on website</td></tr><tr><td>Language</td><td>You can select language that this attachment will be applied to</td></tr><tr><td>Customer roles</td><td>You can select customer roles that this attachments will be showed to</td></tr><tr><td>Limit to stores</td><td>You can select stores that this attachments will be showed on</td></tr></tbody></table>

{% hint style="warning" %}
Name and Icon will not be shown on HTML5 or YouTube Video. Only thumbnail will be shown.\
You can use URL attachment type to make a video with a name, but then thumbnail will not be shown, only name, as a link to that video.
{% endhint %}

### Mapping block

After you fill Main block to your needs, and click Save and continue edit, you will be able to select Products, Categories, or Manufacturers in the Mapping block.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://productattachments.docs.foxnetsoft.com/create-new-attachment.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.