# Layouts

The **Layouts** section under "Customizations” in the **Admin Dashboard** provides the ability to configure and customize the experience of creating a finding.

Multiple layouts allow admins to tailor the finding creation process according to their needs and requirements. Each layout can be designed to capture different findings or accommodate different workflows. For example, a tenant might have different layouts for web application vulnerabilities, network vulnerabilities, or compliance-related issues.

By customizing the layouts, admins can ensure that teams provide consistent and relevant information while creating findings. This can improve report creation by ensuring a standardized approach to documenting security issues.

<div align="left"><figure><img src="https://4252973360-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LXA6EayCcg12qfDcfXd%2Fuploads%2FbelT49CFV8hy69deMMQe%2Fimage.png?alt=media&#x26;token=ec20666d-de42-4ebb-9d67-cd134ee99a7f" alt=""><figcaption></figcaption></figure></div>

{% hint style="info" %}
Layouts only apply to findings created within PlexTrac and don't apply to imported findings.
{% endhint %}

## **Creating a Layout**

<mark style="background-color:yellow;">Step 1:</mark> Click **Layouts** in the **Admin Dashboard** under "Customizations."&#x20;

<div align="left"><figure><img src="https://4252973360-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LXA6EayCcg12qfDcfXd%2Fuploads%2FuRWyzK8dv1oqmgGyepCv%2Fimage.png?alt=media&#x26;token=590cb3d7-ec72-42f7-a4d2-5f5c5066ae82" alt=""><figcaption></figcaption></figure></div>

<mark style="background-color:yellow;">Step 2:</mark> Click **New Findings Layout**.

<div align="left"><figure><img src="https://4252973360-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LXA6EayCcg12qfDcfXd%2Fuploads%2FfpUuywEGmKrbCq3QnQEO%2Fimage.png?alt=media&#x26;token=d20ae9fb-de84-4de1-ae9f-8d19a1625945" alt=""><figcaption></figcaption></figure></div>

<mark style="background-color:yellow;">Step 3:</mark> Confirm if starting from the default layout or leveraging another. Select the layout from the pulldown menu if starting from a custom layout. Click **Create**.

<div align="left"><figure><img src="https://4252973360-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LXA6EayCcg12qfDcfXd%2Fuploads%2FCiaKFpEo8lyriJpYltkf%2Fimage.png?alt=media&#x26;token=83ae858d-b25f-4dc0-8909-ea7c28261da7" alt=""><figcaption></figcaption></figure></div>

<mark style="background-color:yellow;">Step 4:</mark> A new page appears with two tabs: **Finding fields** and **Custom fields**.

Enter a unique and descriptive name for the layout in the "Findings layout name" box, as this value will be provided to users when selecting the layout for a report.

<div align="left"><figure><img src="https://4252973360-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LXA6EayCcg12qfDcfXd%2Fuploads%2FD27p7LhFoOrXqGllMpPN%2Fimage.png?alt=media&#x26;token=3c8d26ea-cb03-4dd5-a541-013d930cd365" alt=""><figcaption></figcaption></figure></div>

<mark style="background-color:yellow;">Step 5:</mark> Arrange the fields to create the desired layout.&#x20;

Click **+** in the left column to add any field to the layout. Click **X** in the right column to remove a field from the layout.&#x20;

{% hint style="info" %}
Fields without an X are required and cannot be removed or made optional.
{% endhint %}

<div align="left"><figure><img src="https://4252973360-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LXA6EayCcg12qfDcfXd%2Fuploads%2F8xcptYvA7fAgZVVA3vcR%2Fimage.png?alt=media&#x26;token=6785b532-6d21-4f3e-bdde-2638c16aa3c7" alt=""><figcaption></figcaption></figure></div>

<mark style="background-color:yellow;">Step 6:</mark> Make any optional fields required by toggling the button for that field to the right so the purple checkmark appears.&#x20;

<div align="left"><figure><img src="https://4252973360-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LXA6EayCcg12qfDcfXd%2Fuploads%2FwC8x0XXZShjhpkNgZdvx%2Fimage.png?alt=media&#x26;token=c7f43fef-0141-45f8-92d6-587fcaa0832b" alt=""><figcaption></figcaption></figure></div>

<mark style="background-color:yellow;">Step 7:</mark> Arrange the fields in the desired order by clicking the row with the cursor and dragging the box to the desired sequence of existing fields.&#x20;

{% hint style="info" %}
The title must be first and cannot be moved.
{% endhint %}

<div align="left"><figure><img src="https://4252973360-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LXA6EayCcg12qfDcfXd%2Fuploads%2FPJHP7Ge8Ae9IrgHwKZvE%2Fimage.png?alt=media&#x26;token=83e35ccc-9ba3-4e45-9822-c80ca9297d6b" alt=""><figcaption></figcaption></figure></div>

<mark style="background-color:yellow;">Step 8:</mark> If applicable, add custom fields by clicking the **Custom fields** tab, then clicking **Add custom field**.

<div align="left"><figure><img src="https://4252973360-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LXA6EayCcg12qfDcfXd%2Fuploads%2FPrY6KDHTiKcReWY6UgiN%2Fimage.png?alt=media&#x26;token=6930a6dc-c827-4a08-aa7d-481ed202ad51" alt=""><figcaption></figcaption></figure></div>

<mark style="background-color:yellow;">Step 9:</mark> Enter desired values in the provided boxes.

<div align="left"><figure><img src="https://4252973360-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LXA6EayCcg12qfDcfXd%2Fuploads%2FMSUlJN5MXKToD8LLWLOQ%2Fimage.png?alt=media&#x26;token=ba9bdbc4-b60d-44c3-ab94-672bd8f55e38" alt=""><figcaption></figcaption></figure></div>

1. **Key:** A required value used to reference this field. This must be a unique value.
2. **Label:** A required value used for the field title and visible elsewhere in the platform.&#x20;
3. **Value:** An optional RTF to capture the field value and provide any additional content to help the user with context and data acquisition.

<mark style="background-color:yellow;">Step 10:</mark> Click **Add custom field** to repeat the process.&#x20;

<div align="left"><figure><img src="https://4252973360-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LXA6EayCcg12qfDcfXd%2Fuploads%2FH6WqcOmYSjJcYBlqakER%2Fimage.png?alt=media&#x26;token=b51ad5c9-6a95-400b-80e5-11695f11218e" alt=""><figcaption></figcaption></figure></div>

<mark style="background-color:yellow;">Step 11:</mark> Click **Save layout** when finished.&#x20;

<div align="left"><figure><img src="https://4252973360-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LXA6EayCcg12qfDcfXd%2Fuploads%2FYqTuL9X9VWx1FkXtbPfs%2Fimage.png?alt=media&#x26;token=9b39846a-4c53-4949-8fc0-c3f9f1fdff8f" alt=""><figcaption></figcaption></figure></div>

A message will appear confirming the layout was created. The new layout will appear in the list for future editing and is now available for assignment to a report.

## Assigning a Layout

After a layout is created, it must be assigned to a report to be leveraged. When creating a new report, this association is set by selecting the desired layout in the pulldown menu under the "Findings Layout" of the Create New Report modal.

<div align="left"><figure><img src="https://4252973360-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LXA6EayCcg12qfDcfXd%2Fuploads%2F3NdxBvJWDSvMoVgXtFIB%2Fimage.png?alt=media&#x26;token=296ae67b-73e1-4237-9362-ee45f1af6fc6" alt=""><figcaption></figcaption></figure></div>

Layouts can also be added to existing reports by going to the **Details** tab of the report, selecting the layout from the pulldown menu under "Findings Layout," and clicking **Save**.

<div align="left"><figure><img src="https://4252973360-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LXA6EayCcg12qfDcfXd%2Fuploads%2FIdkohoHz9ea103bXhy2p%2Fimage.png?alt=media&#x26;token=d0b976fd-8b4c-494b-a2b1-e2c1b4f480be" alt=""><figcaption></figcaption></figure></div>

Only one layout can be assigned to a report.

{% hint style="info" %}
Legacy findings are not impacted when a layout is assigned to an existing report. The new layout will only apply to findings created after the layout was associated.
{% endhint %}

### Custom Fields

Any custom fields added to the layout are available to the user at the bottom of the **Finding Details** tab of the finding.&#x20;

<div align="left"><figure><img src="https://4252973360-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LXA6EayCcg12qfDcfXd%2Fuploads%2Fob0jAXtTATk2KQl4ZzHP%2Fimage.png?alt=media&#x26;token=35eb8749-8887-4cb2-b62b-8263b7539506" alt=""><figcaption></figcaption></figure></div>

If a custom field was added to an assigned layout after a finding was added to a report, the additional custom field is available for data input within a finding by clicking **Add Fields From Template.**

{% hint style="info" %}
Updates made to a layout will not be applied to any legacy reports associated with that layout.
{% endhint %}

## Editing a Layout

<mark style="background-color:yellow;">Step 1:</mark> Click **Layouts** in the **Admin Dashboard** under "Customizations."&#x20;

<div align="left"><figure><img src="https://4252973360-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LXA6EayCcg12qfDcfXd%2Fuploads%2FFzTuSew4S6awO7CrQUSd%2Fimage.png?alt=media&#x26;token=34fcf669-218c-4485-8104-006c6bc601ab" alt=""><figcaption></figcaption></figure></div>

<mark style="background-color:yellow;">Step 2:</mark> Click **Edit** of the layout to revise.

<div align="left"><figure><img src="https://4252973360-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LXA6EayCcg12qfDcfXd%2Fuploads%2FPYIM46fcnNqOdi5WefHa%2Fimage.png?alt=media&#x26;token=e7f5c4f9-8019-4646-8455-093a9c86d7d4" alt=""><figcaption></figcaption></figure></div>

<mark style="background-color:yellow;">Step 3:</mark> Make desired changes and click **Save layout**.

<div align="left"><figure><img src="https://4252973360-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LXA6EayCcg12qfDcfXd%2Fuploads%2F1iXMglNkGzAWAuGkNQsi%2Fimage.png?alt=media&#x26;token=7f33128c-459b-44f0-bb3f-c2aa1ba1d4ad" alt=""><figcaption></figcaption></figure></div>

## Deleting a Layout

<mark style="background-color:yellow;">Step 1:</mark> Click **Layouts** in the **Admin Dashboard** under "Customizations."&#x20;

<div align="left"><figure><img src="https://4252973360-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LXA6EayCcg12qfDcfXd%2Fuploads%2FCdhzINlQi0nVRg17anyK%2Fimage.png?alt=media&#x26;token=1d352ae3-ac60-450e-bc1e-d7f0d9efd766" alt=""><figcaption></figcaption></figure></div>

<mark style="background-color:yellow;">Step 2:</mark> Click **Delete** of the layout to revise.

<div align="left"><figure><img src="https://4252973360-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LXA6EayCcg12qfDcfXd%2Fuploads%2FKI3vNXJAXcUVMQKwjp8n%2Fimage.png?alt=media&#x26;token=7718f986-77c8-448e-ac78-0a24947f5a3d" alt=""><figcaption></figcaption></figure></div>

&#x20;<mark style="background-color:yellow;">Step 3</mark>: A message will appear confirming the action. Click **Delete Layout**.

<div align="left"><figure><img src="https://4252973360-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LXA6EayCcg12qfDcfXd%2Fuploads%2FVFd8IXzfDfcWKw0c5TWN%2Fimage.png?alt=media&#x26;token=e51e67b2-a871-4b2e-ab6a-b9327f71fb96" alt=""><figcaption></figcaption></figure></div>

A notification message will appear confirming the deletion of the layout.
