# Create Workspace for Extension

Before building a Custom Extension, users must first create an **Extension Workspace**.\
The workspace serves as a **development scaffold** that contains configuration, UI metadata, and resources required to build the Extension as a reusable activity node.

ONEWEB Process Designer provides a dedicated interface to generate this workspace automatically.

***

### Accessing the Build Workspace Menu

In **Process Designer**, a new menu is available to manage extensions.

1. Click the **Extensions** icon ![](https://docs.oneweb.tech/oneweb/~gitbook/image?url=https%3A%2F%2F2015371994-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FMpDjHWFRUtZ5nJcSfVXd%252Fuploads%252FKL8QnJLEzUD6XHqbeiYz%252F0%3Falt%3Dmedia\&width=300\&dpr=3\&quality=100\&sign=fd3cfb28\&sv=2)
2. Select **Build Workspace**

This opens the **Build Workspace** screen.

<figure><img src="https://2015371994-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMpDjHWFRUtZ5nJcSfVXd%2Fuploads%2FAkK913OGiwXIVFRUf5ur%2F1?alt=media" alt=""><figcaption></figcaption></figure>

***

### Enter Extension Workspace Details

On the Build Workspace screen, enter the required details for your extension, such as:

* Extension name
* Description
* Package or identifier information

These details define the **identity and metadata** of the custom activity node.

<figure><img src="https://2015371994-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMpDjHWFRUtZ5nJcSfVXd%2Fuploads%2FRu9QB61Ncc3TXbW2ogBK%2F2?alt=media" alt=""><figcaption></figcaption></figure>

***

### Designing the Extension Look & Feel

While creating the workspace, users can also define the **visual appearance** of the custom node.

#### Custom Node Icon

* Drag and drop a custom image into the **Browse File** panel
* This image will be used as the **node icon** in Process Designer

#### Node Background Color

* Change the background color by clicking the **Node Color** field

#### Preview

* The **Node Extension** preview section displays the final appearance of the node
* Users can visually verify the icon and color before proceeding

<figure><img src="https://2015371994-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMpDjHWFRUtZ5nJcSfVXd%2Fuploads%2F0UaXMYz22rCRPL0rRv0b%2F3?alt=media" alt=""><figcaption></figcaption></figure>

***

### Defining Extension Data (JSON Configuration)

Users can define the data structure displayed on the **Extension tab** using a JSON configuration.

* Click the **SET** button in the **Json Generate Form** field
* Define the required input and output structure as JSON

This configuration controls how data is presented and configured when the extension is used in a workflow.

<figure><img src="https://2015371994-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMpDjHWFRUtZ5nJcSfVXd%2Fuploads%2FxVYoexExtNhIopsk795p%2F4?alt=media" alt=""><figcaption></figcaption></figure>

***

### Using Sample Configurations

The **Example** tab provides predefined sample configurations that users can:

* Review for reference
* Use as a starting point for their own extension design

This helps reduce setup effort and ensures correct configuration patterns.

***

### Building the Workspace

Once all configuration details are completed:

1. Review the extension details in the **Node Extension** preview section
2. Confirm the icon, color, and configuration
3. Click **Build Workspace**

<figure><img src="https://2015371994-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMpDjHWFRUtZ5nJcSfVXd%2Fuploads%2FR6VTqQnogHYY3I9PXwG8%2F5?alt=media" alt=""><figcaption></figcaption></figure>

#### Result

* The system generates the extension workspace
* The workspace is downloaded to the user’s machine as a **ZIP file**
* This ZIP file serves as the base for extension development

***

### Summary

Creating an Extension Workspace is the first and essential step in building Custom Extensions.

Key points:

* Workspace is created via **Extensions → Build Workspace**
* Defines extension metadata and UI appearance
* Supports custom icons and node styling
* Allows JSON‑based configuration definition
* Workspace is downloaded as a ZIP file for development

This workspace provides the foundation for building, packaging, and installing reusable **Custom Activity Nodes** in ONEWEB Process Designer.


---

# Agent Instructions: 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:

```
GET https://docs.onewebstack.com/designer-reference/process-designer/process-designer-component/custom-extensions/create-workspace-for-extension.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
