> For the complete documentation index, see [llms.txt](https://cortex-docs.paloaltonetworks.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://cortex-docs.paloaltonetworks.com/cortex-xsiam-developer-guide/cortex-xsiam-development-guide/documentation/content-pack-metadata-file.md).

# Content pack metadata file

Each content pack contains a `pack_metadata.json` file that contains a short description of the content pack that is displayed in Marketplace. The metadata file also contains tags, categories, and use cases for the content pack.

When displayed in Marketplace, content packs contain the following documentation sections:

* **Description**: Displayed in the content pack card when browsing Marketplace and at the top of the **Details** tab.

  Example: Content pack card

  ![xsiam-content-pack-description-card.png](/files/3OxpBv2Leds8QzxrQBJd)

  Example: **Details** tab with Description and README

  ![xsiam-content-pack-description-and-readme.png](/files/p0MIZ8wkuIU6aiGLXwFT)
* **Videos**: Displayed in the main display area and in the middle of the **Details** tab.
* **README**: The content pack README file, if it exists, is displayed in the main display area and in the bottom of the **Details** tab.

#### Pack description

The pack description is the first information users see when they go to your content pack. It's important to give a detailed, thorough description of what the pack contains, use cases, and overall benefits of the pack. The pack description is maintained in the pack\_metadata.json file under the description field. Packs should always contain a description, even if a README file is provided with more details. This enables users to get a short overview of the pack when browsing the Marketplace.

**General description guidelines**

* Short and to the point
* Convey gain/benefit for the user
* If possible - what is unique about this pack (for example, minimal, extended, fast, thorough, streamlined)
* Use active voice (you, yours, do, use, investigate) where possible
* Omit redundancy (do not repeat the name of the pack, do not start with "Use this…")
* Capitalize product names
* Use present tense consistently (for example, if "engages" than "investigates", not "investigating")
* Up to 150 chars
* Up to 4 lines

| Examples                                                  | Before                                                                                                                                                                                                                                                                                                                                         | After                                                                                                                                                                         |
| --------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Turn a "fat" description into a "lean" description        | <p>300 chars / 44 words</p><p>Use this content pack to investigate and remediate a potential phishing incident. The playbook simultaneously engages with the user that triggered the incident, while investigating the incident itself and enriching the relevant IOCs. The final remediation tasks are always decided by a human analyst.</p> | <p>139 chars / 10 words</p><p>Streamline investigation and remediation of Phishing incidents. Playbook engages with users while simultaneously investigates and enriches.</p> |
| Turn a "passive" description into a "active" description: | <p>Passive and impersonal</p><p>Provides data enrichment for domains and IP addresses.</p>                                                                                                                                                                                                                                                     | <p>Active and personal</p><p>Enrichment for your domains and IP addresses.</p>                                                                                                |

Example sentences:

* "Streamline your \_\_\_ process for \_\_\_. Optimized for \_ and \_\_\_\_ this \_\_\_ targeted content pack is ideal for \_"
* "Eliminate \_\_\_\_ by improving your\_\_. Rich with layouts and playbooks, this content pack is right for \_\_\_\_"
* "Get smarter. This pack utilizes \_ and \_\_\_for when \_ is heavily needed"

#### Pack Videos

For larger packs that provide at least one end-to-end use case, you are encouraged to create a short video or a few videos for the pack that are displayed in the **Details** tab of the pack in Marketplace. The videos files should be hosted on YouTube, and they should contain a more detailed overview of the pack compared to the **Description** section.

Add the video link to the pack\_metadata.json file. For example, for the Malware Investigation and Response content pack:

```programlisting
{
    "name": "Malware Investigation and Response",
    "description": "Accelerate the investigation of your endpoint malware alerts and incidents and trigger containment activities quickly.",
    "support": "xsoar",
    "videos": [
        "https://www.youtube.com/watch?v=DtGIefyoTao"
    ],
```

#### Pack keywords, tags, use cases, and categories

To classify packs and make them easier to find, you can use the following pack metadata elements in the pack metadata file.

![xsiam-pack-metadata.png](/files/EHrVmleeuTvBlNddKO5q)

**Use cases**

The use case must be one or more of the [approved use cases.](https://github.com/demisto/content/blob/master/Config/approved_usecases.json)

**Tags**

Tags make it easier to find packs using filters or the search bar, and are visible on the screen to help understand what the pack is and its benefit to users.

Tags must be from the[list of approved tags](https://github.com/demisto/content/blob/master/Config/approved_tags.json).

**Categories**

The high level field/subject the pack relates to. Your pack should fall into one of the [approved existing categories](https://github.com/demisto/content/blob/master/Config/approved_categories.json).

**Keywords**

Keywords operate like tags to assist in searching for packs, but they aren't displayed in the UI. You can add keywords as needed.

For example, for a pack related to messaging, you may want to add "msg" as a keyword so when a user searches for "msg" they will find the pack, but the word "msg" won't display in the UI.

You can add any keywords you want, the list is not restricted.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://cortex-docs.paloaltonetworks.com/cortex-xsiam-developer-guide/cortex-xsiam-development-guide/documentation/content-pack-metadata-file.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
