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

# Uploading Files

> Add files to a work item through the Nextedy MEDIAKIT gallery, and what happens when a file name already exists.

export const LastReviewed = ({date}) => {
  if (!date) return null;
  const formatted = new Date(`${date}T00:00:00Z`).toLocaleDateString("en-US", {
    year: "numeric",
    month: "long",
    day: "numeric",
    timeZone: "UTC"
  });
  return <p className="mt-10 text-sm text-gray-400 dark:text-zinc-500 not-prose">
      Last reviewed on {formatted}
    </p>;
};

Files you add through the gallery become ordinary Polarion attachments on the work item. Nothing is stored anywhere else, and the usual attachment permissions apply — if you cannot add attachments to a work item, you cannot add files to its gallery.

## Prerequisites

* The gallery is configured on the work item's form — see [Adding the Gallery](/mediakit/getting-started/adding-the-gallery)
* The work item has been saved at least once
* You have permission to modify the work item's attachments

## Add Files

<Steps>
  <Step title="Open the gallery">
    Open the work item and find the gallery section on its form.
  </Step>

  <Step title="Choose the files">
    Select the **+** button in the gallery toolbar and pick one or more files. You can select several files at once, and they all upload together.

    When the gallery is empty it shows a drop area with a **Browse files** button.
  </Step>

  <Step title="Confirm they arrived">
    Each uploaded file appears as a tile with a green check mark. Images show a thumbnail; other file types show an icon for their type.
  </Step>
</Steps>

<Warning>
  **Uploading a file whose name already exists replaces it, without asking.**

  There is no confirmation and no warning. The existing attachment keeps its place in the list and its content is replaced with the new file.

  This is the way to update a file in place — but it means an accidental re-upload overwrites the previous version silently. The earlier content is not lost: Polarion keeps it as a previous revision of the attachment, reachable through **Show revisions** in the work item's **Attachments** section.
</Warning>

## The Attachments Section Does Not Refresh on Its Own

Polarion's own **Attachments** section is rendered when the form loads, and it does not update when you upload through the gallery. Immediately after an upload the gallery shows the new files while the Attachments list above still shows the previous set.

Nothing has gone wrong, and the files are genuinely attached. Reload the work item form and both lists agree.

## Next Steps

<Columns cols={2}>
  <Card title="Viewing and Downloading" icon="images" href="/mediakit/guides/viewing-and-downloading">
    Switch views, open an image full size, and download a file.
  </Card>

  <Card title="Deleting Files" icon="trash" href="/mediakit/guides/deleting-files">
    Remove a file from the work item.
  </Card>
</Columns>

<LastReviewed date="2026-09-03" />