Live article: https://www.storyblok.com/faq/how-can-i-create-a-new-release
- FAQ
- How can I create a new release?
With the Release App you're able to create multiple releases which can be scheduled independently. Imagine you want to prepare a specific change on your startpage and release it in three weeks. To do so you can create a release where your changes will life until you schedule them.
Step 1: Creating the release
Creating a new release can be done by clicking on the "+ New Release" button. Next you want to give your release a name so others now what you're working on. You can also already define the schedule for the release, if you don't know it yet don't select a date yet.
Step 2: Edit the entries you want to change
You can now navigate through the current tree of your content and edit the entries you want; You will notice that the Publish button now is called "Schedule" which will publish your changes in this one release and won't schedule the whole release just now. Since you did not make any changes to your entries, checking "Show only items from this release" will result in no entries being displayed. Once you made your changes you can activate it to see which entries you actually changed.
Step 3: Check your changes
Before releasing, scheduling or approval make sure you've made your changes. To do so you can now check "Show only items from this release" to see which entries you actually changed. You will also see a badge on the right side of your entries that indicates in how many releases this entry is included with changes.
Step 4: Release your changes
After checking your changes or sending an approval, you can now go ahead and either release your current release right now, or choose a scheduling date and time. Once released your changes will override the current published content. Only changed entries will be effected.
Option 1: Choosing a scheduling date
Click on the edit button next to your release name. In the overlay you can than select a date and time for the release.
You will see the scheduled date next to the "Release Now" and "Send Approval" buttons with a next like: "Will be released at: 16.1.2019 21:56:00"
Option 2: Release now
Click on release now to release without scheduling. This will bring your current release instantly back to your content stage.
Releases and multiple Pipeline Stages
If you are also using the Pipeline Stages App and added multiple Pipeline Stages your release needs to be deployed to that Pipeline Stages too. Otherwise the release will only get released to the default "Preview" Pipeline Stages.
After you defined a release date of your release you need to go to the Pipeline Stages, click "Deploy" and choose your release from the list.