Beginner May 2, 2026 · 2 min read

Introduction

A workspace in Frappe Framework v15 is a customizable container for your business applications.

It provides a centralized location to organize and manage your apps, data, and user permissions. Creating a new workspace allows you to tailor Frappe to your specific needs and requirements.

Prerequisites

Before you can create a new workspace, ensure you have the following:

  1. Frappe Framework v15 installation: Frappe Framework v15 should be installed on your system.
  2. Frappe account: You need a Frappe user account that has a Workspace Manager role assigned to it to access the platform and create workspaces.

Step-by-Step Guide

Step 1: Log in to Your Frappe Account

  • Open your web browser and navigate to your Frappe instance.
  • Enter your Frappe credentials and click the "Login" button.

Step 2: Navigate to the Workspace Creation Page

  • Once logged in, you should see the "Build" workspace by default if you have not installed ERPNext.
  • If you have installed ERPNext, you will see your “Home” workspace by default.
  • At the bottom right corner of your screen of either the two workspaces you may see, click on the "+ New" button to start the creation process.

Step 3: Provide Essential Information

  • Enter a descriptive name for your workspace.
  • Optionally, add a description to provide more context.
  • Select the appropriate theme for your workspace (if available).

Step 4: Create Your Workspace

  • Click the "Create" button to finalize the workspace creation process.

Best Practices

  • Naming your workspace: Choose a clear and concise name that reflects its purpose.
  • Organizing your workspace: Use folders and subfolders to organize your apps and documents within the workspace.
  • Managing permissions: Assign appropriate permissions to users based on their roles and responsibilities.

Troubleshooting

  • If you encounter any issues during the workspace creation process, refer to the following troubleshooting tips:
    • Check for network connectivity: Ensure you have a stable internet connection.
    • Verify Frappe installation: Make sure Frappe Framework v15 is installed correctly.
    • Consult the documentation: Refer to the official Frappe documentation for detailed troubleshooting steps.

Additional Resources

  • Frappe Documentation:
  • Frappe Community Forums:
  • Frappe Marketplace:

By following these steps and best practices, you can effectively create new workspaces in Frappe Framework v15 and customize the platform to suit your specific business needs.

Was this article helpful?