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

# FAQ

> Answers to common questions about Nextedy MEDIAKIT — configuration, uploads, and limitations.

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

<AccordionGroup>
  <Accordion title="I added the extension to the form layout and no gallery appears">
    Almost always this means the extension went into a form layout the work item does not use.

    Polarion keeps a **separate form layout for each work item type**, and adding the gallery to the wrong one produces no error and no warning — the form simply renders without it. The **-- Unspecific --** layout applies only to types that have no layout of their own, so it does not cover a type that has one.

    Check the type of the work item you are looking at, then confirm the extension is in *that* type's layout. See [Adding the Gallery](/mediakit/getting-started/adding-the-gallery).

    If the gallery is missing on every type, the plugin itself may not have loaded — confirm the `.config` folder was deleted from the Polarion data workspace during installation, as [Installation](/mediakit/getting-started/installation) describes.
  </Accordion>

  <Accordion title="I uploaded a file with a name that already existed — where did the old one go?">
    It was replaced, deliberately and without a prompt. Uploading a file whose name matches an existing attachment replaces that attachment's content rather than adding a second file.

    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.

    This is the intended way to update a file in place. See [Uploading Files](/mediakit/guides/uploading-files).
  </Accordion>

  <Accordion title="I uploaded a file but the Attachments section still shows the old list">
    The upload worked. Polarion renders its Attachments section when the form loads and does not refresh it when you use the gallery, so immediately after an upload the two disagree.

    Reload the work item and both show the same files. See [Gallery and Attachments](/mediakit/concepts/gallery-and-attachments).
  </Accordion>

  <Accordion title="Can I export a rich page containing the widget to PDF?">
    Not with the gallery included. A PDF export of a page containing the Mediakit Upload widget renders a message where the gallery would be, rather than the gallery itself.

    If the page must be exported to PDF, keep the widget off it, or accept that the gallery will be absent from the exported file.
  </Accordion>

  <Accordion title="Why does one of my file types show an icon instead of a thumbnail?">
    Only image formats render thumbnails. Recognised non-image formats — PDFs, video, text — are given an icon for their type, and a file whose extension is in neither map gets a generic tile.

    If a format you expect to be treated as an image is showing a generic tile, its extension may not be in the image map. Both maps are configurable: see [Supported File Types](/mediakit/reference/supported-file-types) for the defaults and [Configuring File Types](/mediakit/guides/configuring-file-types) for how to change them.
  </Accordion>

  <Accordion title="Do I need a licence?">
    Mediakit is commercially licensed, and the download includes a 30-day evaluation licence so you can trial it before buying.

    For production use, place the licence file in the `license` folder of your Polarion installation, as [Installation](/mediakit/getting-started/installation) describes. When the licence is not valid the gallery reports the problem rather than failing silently.
  </Accordion>

  <Accordion title="Who can upload and delete files?">
    The same people who can modify the work item's attachments in Polarion. Mediakit applies no permission model of its own — it acts on ordinary attachments, so your existing project permissions decide who may change what.
  </Accordion>

  <Accordion title="If we uninstall Mediakit, do we lose the files?">
    No. Every file shown in the gallery is an ordinary Polarion work item attachment. Removing the plugin removes the gallery view; the attachments remain on their work items exactly as before, reachable through Polarion's own Attachments section.
  </Accordion>
</AccordionGroup>

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