---
category: [Administration & Integrations, Platform and Product Extensions, Platform and Product Extensions/Integration, Administration & Integrations/Custom Integrations & Apps, Platform and Product Extensions/Workday Extend]
keyword: Extend
nav: wcp_docs
parent_url: /wcp_docs/
title: Create Apps Using the Workday Extend Plugin for IntelliJ
layout: subsection
---

### Prerequisites

<a id="prereq_N10021_N1001E_N10001"></a>
-   Workday Extend Plugin for IntelliJ.
-   Account on a WCP Development tenant.


### Context

<a id="context_N1003D_N1001E_N10001"></a>
Create a custom app using IntelliJ and the Workday Extend Plugin for IntelliJ. Use the Workday Extend Plugin for IntelliJ to code presentation, site, and app metadata files. After you've coded your app, upload it to App Hub and deploy it to a Development tenant to test it.

<b>The Reference ID of an App</b>

The reference ID of an app follows this naming convention: `<appId>_<companySuffix>`, where:

-   `<appId>` - The ID entered when creating the app with the Workday Extend Plugin for IntelliJ. This ID must:

    -   Be unique within the company.
    -   Be meaningful and easily identifiable across Workday Extend tools and logs.
    -   Begin with a letter.
    -   Use `a–z`, `A-Z`, `0–9`, `.`, or `-`.

-   `<companySuffix>` - A unique ID for your company.


After you create your app and upload it to App Hub, App Hub automatically appends the `<companySuffix>` to the `<appId>` to create the unique reference ID of your app. Example: `myWcpApp_zsttxv`.

<b>Note:</b> You can't reuse the Reference ID of an app, even if you delete the app from the Workday Developer Site.

### Steps

1.  <a id="step_N10047_N10043_N1001E_N10001"></a>Open IntelliJ.
2.  <a id="step_N1007B_N1006E_N10048_N10001"></a>Select <b>Tools</b> &gt; <b>Workday Extend</b> &gt; <b>Log in to Workday Extend</b>.

    Enter your Workday Developer Site credentials on the browser.

3.  <a id="step_N10098_N1006E_N10048_N10001"></a>In IntelliJ, select <b>Tools</b> &gt; <b>Workday Extend</b> &gt; <b>Log in to Tenant</b>.

    Select a tenant, and enter your tenant credentials on the browser.

4.  <a id="step_N1004D_N10040_N1001E_N10001"></a>If you don't have an existing project in IntelliJ, select <b>File</b> &gt; <b>New</b> &gt; <b>Project...</b>

    On the <b>New Project</b> window, select <b>Workday</b>.

5.  <a id="step_N10050_N10043_N1001E_N10001"></a>If you're creating a new project, skip this step. Otherwise, open your existing project, and select <b>File</b> &gt; <b>New</b> &gt; <b>Workday Extend</b> &gt; <b>Create New App</b>.

    Alternatively, right-click the `apps` folder, and select <b>New</b> &gt; <b>Create New App</b>.

6.  <a id="step_N100BA_N10070_N10048_N10001"></a>Select 1 of these options:

<table><thead><tr><th>    Option</th><th>    Description</th></tr></thead><tbody><tr><td><b>New Blank App</b></td><td>Creates a default app with a simple home page.</td></tr><tr><td><b>Import from App Hub</b></td><td>Creates a new app by importing an app from App Hub. You can select an existing app you have access to in App Hub.</td></tr><tr><td><b>From Local File</b></td><td>Creates a new app by importing an app from a folder or a <code>.zip</code> file containing a Workday Extend app.</td></tr></tbody></table><br/>

7.  <a id="step_N1007F_N10040_N1001E_N10001"></a>Enter the app information:

<table><thead></thead><tbody><tr><td><b>App Name</b></td><td>The display name of your app.</td></tr><tr><td><b>Reference Id</b></td><td>The unique identifier of your app within your company. <p>Enter a meaningful ID that makes it easy to identify your app across Workday Extend tools and logs. Begin the ID with a letter, and only use <code>a–z</code>, <code>A-Z</code>, <code>0–9</code>, <code>.</code>, or <code>-</code>.</p></td></tr><tr><td><b>App Description</b></td><td>Optional description.</td></tr></tbody></table><br/>

8.  <a id="step_N100C1_N10040_N1001E_N10001"></a>If you created the app in an existing project, skip this step. If you're creating a new project, enter the IntelliJ project name and location.

    Example: WorkdayApps.

9.  <a id="step_N1016B_N10070_N10048_N10001"></a>Click <b>Finish</b>.


### Result

<a id="result_N10070_N1001E_N10001"></a>
The Workday Extend Plugin for IntelliJ adds a new subfolder for your new app under the `apps` folder. The App Metadata (AMD) and Site Metadata (SMD) files use the Reference ID you provided.

### Next Steps

<a id="postreq_N1007B_N1001E_N10001"></a>
-   Upload your app to App Hub, and deploy it to the Development tenant.

    <b>Note:</b> When you upload your app to App Hub, it updates the Reference ID with the appended company suffix. The Workday Extend Plugin for IntelliJ will update the Reference ID in the app folder name and files.

-   Add widgets and pages to your app.

    To add a new page, right-click the `presentation` folder in your app, and select <b>New</b> &gt; <b>Presentation Component</b> &gt; <b>Pmd File</b>. Enter the `id` of the new page.

    The Workday Extend Plugin for IntelliJ creates a default PMD file, and adds a task in the `tasks[]` section of the AMD. The default `routingPattern` is the page `id`. If you need to customize the routing pattern of the page in the app URL, you can override the default `routingPattern` in the AMD.