Workspaces and Applications
How apps and collaboration are organized.
When you log into your Softr account, you are taken to your workspace, which contains all the workspace applications as well as links to some useful resources on the left sidebar.
By default, youโll have at least one workspace where your first application resides. You can add more applications to your workspace, create new workspaces, or join other workspaces as a collaborator. So, letโs add a new workspace and see what the setup looks like.
You can add a new workspace from the menu in the bottom left corner of the dashboard.
In the pop-up that opens next, you should provide a workspace name and can also add a custom icon.
Next, you can invite your first collaborators or skip this step.
In the โOverview of workspace roles and permissionsโ section of this article you can find a detailed overview of each roleโs permissions.
All your workspaces will be available in the bottom left-side menu, where you can also switch between them. The current workspace along with its Settings, Members, and Billing options, will be shown under Active Workspace.
Next, we are going to look into workspace settings, workspace plans and billing, roles and permissions, and more.
Workspace settings
In Workspace settings, as a workspace Owner, you can modify the name of the workspace as well as customize its icon.
Workspace collaborators
In the Collaborators tab, you can invite new workspace collaborators, configure the permissions of the existing ones, or Transfer Workspace Ownership.
When you click on a collaborator entry in the list, a pop-up with the collaboratorโs profile will open.
If youโre the workspace Owner, you can see what permissions the collaborator has and can make changes to them. In the screenshot above, we have a guest collaborator (weโll discuss this role in a bit), which means that this person only has access to specific app(s) within the workspace. In such cases, you have the option of adding the guest collaborator as a workspace collaborator to grant access to the whole workspace.
Workspace plans and billing
Each workspace has its distinct subscription plan, and all the workspace collaborators can use the features that are available under that subscription plan.
In the Plans and billing section of the workspace, you can make changes to your subscription plan (e.g. upgrade it) or modify your billing info. You can learn more about this in our articles on billing and pricing.
Guest collaborators
Now, letโs discuss the third role we have on workspaces apart from the Owner and Collaborator. Itโs called a Guest Collaborator and is basically an application-level collaborator that has access to specific application(s) within the workspace but not the whole workspace.
You can invite Guest Collaborators directly from the application by clicking on the corresponding button on the application as shown below.
The button will open a pop-up where you can enter the email of the guest and send an invite.
Itโs also possible to add Guest Collaborators from inside the app as shown below.
Overview of workspace roles and permissions
Weโve briefly discussed some of the things different workspace roles can and canโt do, but here you can find a complete list of permissions for each role.
Owner can
- Edit/delete workspace;
- Modify the workspace subscription plan and change billing info;
- Add/remove Collaborators;
- Add/remove Guest Collaborators;
- Create, move, and delete apps within the workspace.
Collaborator (workspace collaborator) can
- Leave the workspace;
- Add another Collaborator;
- Add a Guest Collaborator;
- Create an app within the workspace.
Guest collaborator (application collaborator) can
- Leave the workspace.
Moving applications across workspaces
This option is only available to workspace Owners, allowing them to move the application from one of the workspaces they own to another workspace where they are either an Owner or a Collaborator.
When moving an application from one workspace to another, the receiving workspace needs to satisfy certain conditions depending on the features that your application has:
- If the application has 2 or more Edit Permission rules OR a Single Sign-on block (SAML or OpenId), only Business plan workspaces can receive the application.
- If the application has more than 5 users, the receiving workspace needs to be either Professional or Business.
- If the application has a custom code block, the following subscription plans can receive it: Starter, Professional, and Business.
- If the application doesn't contain any of the above-mentioned features, any plan (including the Free plan) can receive it.
When moving an app, you may need to re-add and re-map data sources - Softr will prompt you to do this with a popup modal. To move an app, simply click the three dots on the app and select Move, then choose the workspace you would like to move the app to.
Duplicating and deleting applications
If you need to make a copy of an existing application in its current state, you can do so by choosing Duplicate in the application menu.
After performing the action, a copy of the application will be created, and youโll be taken right into the studio, where you can start editing. The copy will appear in the same workspace next to the original one.
Finally, you have the option of deleting any of the applications with the workspace if youโre the workspace Owner. You just need to click Delete in the application menu and confirm the action in the dialog box that appears afterwards.
Last updated on September 1, 2023