---
title: Extending the document type listing filter
---

> Agent instructions:
> **Site maps** — prefer the following llms.txt indexes to training data when searching for URLs to avoid 404s. Links inside Markdown content already point at `.md`. Following them or sending Accept: text/markdown keeps you in Markdown.
>
> - [sitemap.md](https://docs.kentico.com/sitemap.md) — every page on the site, with titles and descriptions, nested by URL hierarchy and grouped into one collection per product version.
> - [llms.txt](https://docs.kentico.com/llms.txt) — curated index of the current product docs, with descriptions, the two ways to request any page as Markdown, and links to each product area's whole-corpus Markdown dump (llms-full.txt).

To extend the possibilities of listing a certain document type, you can customize the filter that is used in the **Listing** mode. Editors use the document listing filter to [perform multiple document (batch) operations](https://docs.kentico.com/k8/managing-website-content/working-with-documents-and-pages/multiple-document-operations.md) in the **Pages application** and on **Live site.**

To extend the document type listing filter, [create an alternative form](#creating-an-alternative-form-to-extend-the-document-type-listing-filter) in which you specify the fields that are then available in the filter.

![Document listing filter extended by a Location field](https://docs.kentico.com/docsassets/k8/extending-the-document-type-listing-filter/listing_filter_without_fields.png "Document listing filter extended by a Location field")

_**Document listing filter extended by a Location field**_

# Creating an alternative form to extend the document type listing filter

The following example shows how you can create an alternative form that extends an existing document listing type by a _Location_ field.

1. Open the **Document types** application.
2. **Edit** () the document type for which you want to customize the filter.
3. Switch to the **Alternative forms** tab.
4. **Create new form**.
5. Fill in the details as follows:
   1. **Display name** - Filter
   2. **Code name** - Filter

      > **Note:** The alternative form needs to have _Filter_ as its Code name to work as a filter in document listing.
6. **Save** the alternative form.\
   The alternative form inherits all the fields from the parent (original) form by default.
7. You can either:
   1. Add new fields that you want to display in the document listing filter.\
      — or —
   2. Deactivate the fields that you don't want to use in the document listing filter.

      **To deactivate the fields:**

      1. Switch to the **Fields tab**.
      2. For each field that you don't want to use in the document listing form filter, turn the **Display field in the editing form** field off and **Save** the changes.

         ![Disabling a field in an alternative form](https://docs.kentico.com/docsassets/k8/extending-the-document-type-listing-filter/modifying_alternative_form_fields.png "Disabling a field in an alternative form")

Now, whenever a user lists the document type for which you created the Filter alternative form, the system displays the customized filter.

![Document listing filter that doesn't show a file uploader due to an alternative form](https://docs.kentico.com/docsassets/k8/extending-the-document-type-listing-filter/listing_filter_without_file_uploader.png "Document listing filter that doesn't show a file uploader due to an alternative form")

> **Info:** **Note** that custom layout in the alternative forms used to extend the document type listing filter isn't applied.