---
title: "Custom Employment History Page"
slug: "custom-employment-history-page"
description: "Create a tailored employment history page in Slate with custom widgets for detailed work history collection, enhancing applicant experiences."
tags: ["Custom Application Pages", "Jobs", "Slate-Hosted Application"]
updated: 2025-10-07T13:37:34Z
published: 2025-10-07T13:37:34Z
---

> ## Documentation Index
> Fetch the complete documentation index at: https://knowledge.technolutions.net/llms.txt
> Use this file to discover all available pages before exploring further.

# Custom Employment History Page

> [!NOTE]
> 📚 Part of the series **Application Building Phase II:**[**The Slate-hosted Application**](/v1/docs/introduction-to-the-slate-hosted-application)

In the default Slate-Hosted Application, the employment history page (identified by the part ID `job`) consists of a pre-made module that allows students to enter their work history.

![Employment_History_Page.png](https://cdn.us.document360.io/cd8ea7a6-07f3-4846-a554-627ac016d3e3/Images/Documentation/4710061612187.png)

This article covers creating a **custom employment history page** in the Slate-Hosted Application using a Slate-Hosted Application Page-scoped form. The standard employment history page can be mimicked—and expanded upon—with the **job widget.**

#### Four steps to creating a custom employment history page

1. Create a Slate-hosted-application-page-scoped form.
2. Create a widget-scoped form.
3. Add the widget to the Slate-hosted-application-page-scoped form.
4. Add the Slate-hosted-application-page-scoped form to a Slate application.

## Step 1: Creating the Slate-hosted application page

This form serves as the **host** for the widgets you'll create later.

1. Select **Forms** from the main navigation.
2. Click **New Form**. A popup appears.
3. In the New Form popup, configure the following:
  - **Page Title**: The page title will display to an applicant as the name of the page.
  - **Folder:** Keep organized by saving application pages within a clear folder structure.
  - **Status:** Set the status to **Confirmed/Active**.
4. Click **Save**.
5. Click **Edit Form**on the right side.
6. Click **Edit Properties.**A popup appears.
7. In the Edit Properties popup, configure the following:
  - **Scope:**Select **Slate-Hosted** **Application Page.**
8. Click **Save.**

[![Slate_Hosted_Application_Page_Scope.png](https://cdn.us.document360.io/cd8ea7a6-07f3-4846-a554-627ac016d3e3/Images/Documentation/4710406624923.png)](https://cdn.us.document360.io/cd8ea7a6-07f3-4846-a554-627ac016d3e3/Images/Documentation/4710406624923.png/Slate_Hosted_Application_Page_Scope.png)

## Step 2: Creating the widget

> [!NOTE]
> Try a Slate Example 💼
> 
> Use [Suitcase](/v1/docs/suitcase-import) to import our ready-made example Job Widget form. **Open and re-save each form field** to break any potential cache from the suitcase import.
> 
> ```plaintext
> 2e6d0019-fc0b-4542-851e-545d4a627217:slate-examples
> ```

1. Select **Forms** from the main navigation.
2. Click **New Form**. A popup appears.
3. In the New Form popup, enter the following:
  - **Page Title:** Give the form a descriptive title.
  - **Status:**Set the status to **Confirmed/Active.**
  - **Folder:**Add the form to an existing folder or select **Other**to create a new one.
4. Click **Save**.
5. Click **Edit Form** on the right side.
6. Click **Edit Properties.** A popup appears.
7. In the Edit Properties popup, configure the following:
  - **Scope:**Set the form's scope to **Job Widget**within the section Page Construction Widgets.
8. Click **Save**.

[![Job_Widget_Scope.png](https://cdn.us.document360.io/cd8ea7a6-07f3-4846-a554-627ac016d3e3/Images/Documentation/4710494093083.png)](https://cdn.us.document360.io/cd8ea7a6-07f3-4846-a554-627ac016d3e3/Images/Documentation/4710494093083.png/Job_Widget_Scope.png)

1. Configure the widget with the form fields applicants should complete. [![Form_Fields_Example.png](https://cdn.us.document360.io/cd8ea7a6-07f3-4846-a554-627ac016d3e3/Images/Documentation/4710597098907.png)](https://cdn.us.document360.io/cd8ea7a6-07f3-4846-a554-627ac016d3e3/Images/Documentation/4710597098907.png/Form_Fields_Example.png)
2. Configure **Custom List Fields** under Edit Properties. It is necessary to establish one or more exports to appear as the columns in the widget table. Without any exports, no data will show.

> [!CAUTION]
> 🔔 Important!
> 
> Map all fields in the widget to system fields of the same scope. Any custom fields created to be used in the widget should match the scope of the widget.

After the widget form is configured, add exports to define the data columns displayed back to the person completing the form.

1. Click **Edit Properties**.
2. Under **Custom List Fields**, add the desired exports to display data entered in the widget.
3. Click **Save**.

## Step 3: Adding the widgets to the host form

1. From the form builder palette, drag in a **Widget Table**.
2. Edit the widget table. Select one of the widget forms created in the previous section from the Widget Form list. [![Widget_Form_-_Job_Widget.png](https://cdn.us.document360.io/cd8ea7a6-07f3-4846-a554-627ac016d3e3/Images/Documentation/4710764354331.png)](https://cdn.us.document360.io/cd8ea7a6-07f3-4846-a554-627ac016d3e3/Images/Documentation/4710764354331.png/Widget_Form_-_Job_Widget.png)
3. Repeat for any additional widgets created. Drag the widget table form fields to reorder on the page.
4. Add any additional fields or instructions to the form.

## Step 4: Adding the host form to a Slate-hosted application

1. Select **Database** from the main navigation, then select **Application Editor**.
2. Choose the `/apply/` link for the application base to which the new page should be added.

**📝 Note:**If only one application base exists, only `/apply/`**will appear.
3. Click **Edit Menu** in the upper-right.
4. Click **Add Link**. Enter the following configurations:
  - **Type**: Select **Custom Form Page**.
  - **Subtype**: Select the Slate-Hosted-Application-Page-scoped form you created.
  - **Label**: Enter the name to display as the page link in the application navigation.
5. Click **Save**. The new form will be listed at the bottom of the application menu.
6. Drag this page to where it belongs in the application page order.

[![Add_to_Application.png](https://cdn.us.document360.io/cd8ea7a6-07f3-4846-a554-627ac016d3e3/Images/Documentation/4710697919643.png)](https://cdn.us.document360.io/cd8ea7a6-07f3-4846-a554-627ac016d3e3/Images/Documentation/4710697919643.png/Add_to_Application.png)

The application form widget is now active in the application. Be sure to test that data entered into the widget is saved back to the appropriate table on the Profile tab of the Person record.