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

# Adding the Gallery

> Add the Nextedy MEDIAKIT gallery to a Polarion work item form by editing the form layout for each work item type.

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

## What You Will Achieve

By the end of this tutorial the Mediakit gallery will appear as a section on the work item form, ready to accept files.

## Prerequisites

* Mediakit installed on your Polarion server — see [Installation](/mediakit/getting-started/installation)
* Administrator access to the project you want to configure
* A project with at least one work item you can open

<Warning>
  **The gallery is added per work item type.**

  Polarion keeps a separate form layout for each work item type. Adding Mediakit to the wrong layout does nothing at all — the form simply renders without the gallery, with no error and no warning to tell you why.

  Add it to the layout of every type that should show the gallery. The **-- Unspecific --** layout applies only to types that have no layout of their own.
</Warning>

## Add the Gallery

<Steps>
  <Step title="Open Form Configuration">
    In the project, go to **Administration → Work Items → Form Configuration**.
  </Step>

  <Step title="Find the layout for your work item type">
    Scroll past **Form Filters** to the **Form Layouts** table. It lists one row per work item type, plus a **-- Unspecific --** row.

    Pick the row for the type you want the gallery on and select **Edit**. A basic XML editor opens.
  </Step>

  <Step title="Add the extension element">
    Add an `extension` element where you want the gallery to appear. Placing it after the `attachments` field puts the gallery directly below Polarion's own attachment list:

    ```xml theme={null}
    <field id="attachments"/>

    <extension id="MediaFormExtension" label="Mediakit" mode="grid" height="400"/>
    ```

    The `label` is the section heading readers will see, so choose whatever suits your project. `mode` and `height` are optional — see [Form Extension](/mediakit/reference/form-extension) for what they accept.
  </Step>

  <Step title="Save and open a work item">
    Save the layout, then open a work item of that type. The gallery appears as its own collapsible section, headed with the `label` you set.
  </Step>
</Steps>

<Frame caption="The Mediakit gallery on a work item, below Polarion's own Attachments section">
  <img src="https://mintcdn.com/none-17b4493f/Q8wAleJRHSFLELej/mediakit/images/gallery-on-work-item.png?fit=max&auto=format&n=Q8wAleJRHSFLELej&q=85&s=bff399cdfdc813d3df475e631ea4df6b" alt="A work item form showing the Attachments section above a Mediakit gallery section containing three file tiles" width="2610" height="920" data-path="mediakit/images/gallery-on-work-item.png" />
</Frame>

## Repeat for Other Work Item Types

The gallery now appears only on the type whose layout you edited. To show it elsewhere, repeat the steps above for each additional type.

## Next Steps

<Columns cols={2}>
  <Card title="Uploading Files" icon="upload" href="/mediakit/guides/uploading-files">
    Add files to the gallery and understand what happens when a name already exists.
  </Card>

  <Card title="Form Extension" icon="table-list" href="/mediakit/reference/form-extension">
    Every attribute the extension element accepts, with defaults.
  </Card>
</Columns>

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