Configuring your Space

To configure your space in the Settings Area, you must be an Admin or Owner of the space to gain access.

app.storyblok.com
Screenshot of the Settings menu and showing Space tab

The settings of the space are dynamic and will adjust to the installed apps in your space. Only default settings are described in this chapter. App-dependent settings are described in each app documentation.

Space

Under this tab, you will find general configuration related to the space.

Action Description
Space Name You can adjust the name of the space.
Space ID You can copy the ID of the space for support.
Default Content Type You can define the default content type for the stories you create in the space.
   

Subscription

The Subscription tab is available only for the owner, and users who have permission, to see and change the subscription. You can choose one of the five plans or edit/cancel your active subscription.

app.storyblok.com
Storyblok Subscriptions

Under the Subscription tab you can see the details of your current plan, or you can choose the plan you wish to subscribe to.

hint:

If you want to return to the Free plan called “Community” you can follow steps in this FAQ Entry.

Visual Editor

Under the Visual Editor tab, you can set the default location for the Visual Editor and define multiple preview URLs (environments) for it. You can also disable the Visual Editor for all the space, in case you don’t want the editors to use it. Finally, you can also set the dimensions for the Responsive View shortcut included in the Visual Editor.

First you need to choose an access level for the token and then an optional name (which we strongly recommend). You can decide between the Public and Preview access level and you can find out more about the token in the API-tokens documentation.

Internationalization

You can enable the localization of the content by adding a new language in this tab. You may choose as many languages as you need.

learn:

We strongly recommend that you read our guide for the creation of the multi-language website/application.

Webhooks

You can define webhooks for events. You can configure one that will be triggered whenever you publish/unpublish content, another one whenever a datasource is saved, and another webhook to manage workflow stage changes. You can also review the webhooks log, and configure the security used to connect with them.

You can read more about webhooks in this guide.

Access Tokens

You can create multiple API-tokens for your space and use them in different environments to present your content. First you need to choose an access level for the token and then an optional name (which we strongly recommend). You can decide between the Public and Preview access level and you can find out more about the token in the API-tokens documentation.

hint:

The access level of the token can’t be changed later on. A new token must be generated with each new access level.

In short, Public access tokens are only for accessing the published version, while Preview tokens are for accessing the published AND draft versions.

learn:

These tokens are read-only and cannot be used to edit the content. To edit the content use your user authentification token - read more here.

Workflow

Storyblok enables you to define a workflow for your content in all plans except the free one. By default, a new project already has three predefined workflow stages, but you can edit them or create new ones.

Configuration of the workflow stage You open the configuration by clicking on the cog icon next to the name of the stage. It will open the configuration options for you where you can change the name and color of the stage.

For further details on how to configure and use workflows see this article about workflow managment.

Asset Library

Under this tab you can configure details related to the Asset Manager, like required fields when uploading files or settings related to Storyblok’s Image Service.

Backup & Restore

Use your Amazon S3 bucket to create backups. Under this tab, you can configure the automatic backup process, or restore spaces from previous backups.

You can read more about backing up your content in this guide.

Users

You can manage the users of the space and their roles in the space in this section. You can also invite a new user to join the space, and change any user roles.

Changing the role of a collaborator

If you are admin, you can change the roles of a user. You can add/remove the role from the user by opening (click on the cog icon) the settings overlay of the user.

hint:

One user may have multiple roles.

Changing the owner of a space

If you need to change the owner of the space, open the settings (click on the cog icon) of the current owner of the space and enter the email of the new owner.

required:

Email for the users already using Storyblok.

Roles

hint:

There are two default roles in each space - Admin and Editor. You can’t edit them.

Creating a new role

Click on the Add new role button. Fill in the name of the role and a short description of it (optional, but recommended). Below that, you can define different access rights and security configurations related to the role. Click on the Save button at the top-right corner when your new role is ready to be used.

Slack Integration

You can configure Slack notifications for the published event.

Maintenance mode

You can block all non-admin users from changing the content.

Danger Zone

You can permanently delete the space here.