> ## 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.

# Deleting Files

> Remove a file from a work item through the Nextedy MEDIAKIT gallery.

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>;
};

Deleting a file in the gallery removes the attachment from the work item. It is the same operation as deleting the attachment in Polarion's own Attachments section.

## Prerequisites

* You have permission to modify the work item's attachments

## Delete a File

<Steps>
  <Step title="Find the file">
    Locate its tile in the gallery, in either grid or list view.
  </Step>

  <Step title="Select the delete control">
    Each tile carries a delete control alongside its download control.
  </Step>

  <Step title="Confirm">
    The browser asks you to confirm before anything is removed, naming the file it is about to delete.

    The name in that prompt is the attachment's internal identifier, which carries a numeric prefix — a file you uploaded as `notes.txt` is named in the prompt as `5-notes.txt`. That prefix is assigned by Polarion; it does not mean a different file.
  </Step>
</Steps>

The file disappears from the gallery as soon as you confirm. Polarion's own Attachments section still lists it until you reload the work item — see [Gallery and Attachments](/mediakit/concepts/gallery-and-attachments).

<Warning>
  **Deleting is not the way to replace a file.**

  To put a newer version in place of an existing file, upload the new file under the same name — it replaces the content and keeps the earlier version in the attachment's revision history. Deleting first loses that continuity. See [Uploading Files](/mediakit/guides/uploading-files).
</Warning>

## Related

<Columns cols={2}>
  <Card title="Uploading Files" icon="upload" href="/mediakit/guides/uploading-files">
    Add files, and replace one in place.
  </Card>

  <Card title="Gallery and Attachments" icon="paperclip" href="/mediakit/concepts/gallery-and-attachments">
    Why the Attachments table can lag behind the gallery.
  </Card>
</Columns>

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