Pinning Projects to Stable FlutterFlow Studio Versions
FlutterFlow Studio is constantly evolving to provide new features, address bugs, and keep up-to-date with Flutter and third-party packages. However, frequent updates can introduce unwanted changes that break existing projects—especially those that rely on custom code with external dependencies.
To mitigate these issues, FlutterFlow Studio offers a version management system that allows you to pin your project to a particular stable release of FlutterFlow Studio. Projects pinned to a stable release will not automatically receive the latest FlutterFlow Studio updates, giving you more control over your development workflow.
However, pinning to a stable release means that you will not be able to use the latest features, and there may be bugs that are not fixed until subsequent releases. We only recommend doing this if you have a complex app with custom code dependencies.
When should you pin your project to a stable version?
Pinning your project to a stable version of FlutterFlow Studio offers the following benefits:
- Prevents Unexpected Breakages: FlutterFlow Studio updates can introduce errors into your project—particularly when you have custom code. Pinning to a stable release reduces the risk of unexpected changes to your project.
- Gives Control Over Update Timing: FlutterFlow Studio updates might occur at inopportune times (e.g. right before you plan to release a new version of your application). Pinning your project to a stable version allows you to choose when to move your project to a newer release.
Key Concepts
To understand FlutterFlow Studio’s version management system, it’s important to understand Semantic Versioning.
FlutterFlow Studio tends to release a new version of the product each week. When a new version is released, the overall version number is incremented.
The version number consists of three parts:
- Major Version: Incremented when introducing substantial changes that significantly alter the product.
- Minor Version: Incremented for changes that notably enhance or modify the FlutterFlow Studio development experience—such as upgrading to a new Flutter version, making substantial modifications to generated code or project structure, or introducing major new features.
- Patch Version: Incremented with routine releases that include bug fixes and minor improvements, ensuring stability without introducing breaking changes to the generated code or project structure.

You can see what version of FlutterFlow Studio you are using by looking at the top left hand corner of the builder.

Standard Release
A Standard Release of FlutterFlow Studio is released approximately every week. However, this is subject to change based on user needs.
When your project is not pinned to a stable release (default behavior), you will automatically use the latest standard release.
Stable Release
A Stable Release of FlutterFlow Studio is published monthly if any of the following conditions are met:
- Significant changes have been made to project code generation.
- The underlying Flutter version or Pubspec dependencies in generated projects have been updated.
- Updates affecting the project structure have been introduced (e.g., the addition of a new widget type).
Each stable release is assigned a unique Major.Minor version number. Projects that have not been edited in a FlutterFlow Studio version with a Major.Minor version higher than the stable release can be pinned to that stable version.
Pinning Your Project
To pin your project, navigate to Settings and Integrations > General > App Details >Version Pinning section and select the stable release you want to lock into.

Modifying the Pinned Version
You have several options when it comes to modifying pinned version of your project:
- Upgrade to more recent Stable Version: When a new stable version is released, you will see it as an option in the dropdown shown above. You can upgrade the pinned version to a more recent stable version whenever it becomes available. Newer stable versions will have higher numbers (i.e., 5.1 is newer than 5.0)
- Set to Latest Version (Unpinned): You can unpin your project by setting it to the Latest Version which will use the latest standard release.
- Opt-in to the Next Stable: Your project may be on a standard version that does not have a corresponding stable version (i.e., you are on 5.0.1 but the 5.0 stable will correspond to 5.0.4). In that case, you can choose to opt-in to the Next Stable Version. If it is already available, it will be pinned to that version immediately.
Accessing the Proper Stable Version
As mentioned above, once you update your project to a stable version, you can only edit the project using that version of FlutterFlow Studio.
- For Web: You will be automatically redirected to the URL for the stable version that your project is pinned to when you open a project from the FlutterFlow Studio dashboard (i.e., navigating to app.flutterflow.io or enterprise-[region].flutterflow.io).
- For Desktop: You will install the dedicated desktop application for the pinned stable release. The desktop app for stable releases won’t auto-update, you will need to install a new version when you upgrade your project to a new stable version.
Recommended FlutterFlow Studio Version Workflow
If you have a complex app with custom code that depends on specific versions of package dependencies, it may be helpful to pin your project to a specific version. This is the workflow we recommend for managing the version of your projects.
- If you think your project should be pinned to a stable release, choose to pin a currently available stable version (if any).
- When a new stable version is released, you can choose when you would like to upgrade based on your own release schedule and development process. For instance, you might wait until you’re not actively developing a new feature, or you could check the release notes first to see if there are must-have features that would prompt you to upgrade sooner.
- When you’re ready to upgrade, commit all your changes on main to save your progress. Create a new branch from the main branch, update the pinned version, and test all functionalities to ensure compatibility. If any modifications are needed, make those changes in the new branch.
- Run your app on the platforms you support—using a simulator, emulator, or physical device to ensure everything works as intended. See the Local Run documentation for details.
- If everything looks good, you can merge the new branch into the main branch. However, to merge branches successfully, ensure that both the main branch and the new branch are pinned to the same FlutterFlow Studio version! If for some reason your app is not working as expected, you can choose to leave or close the branch until you are ready to make the modifications needed to support the latest FlutterFlow Studio version (i.e. upgrade dependencies/custom code).
Version Management with Libraries
Libraries have their own versions. Like projects, libraries edited in FlutterFlow Studio can only be used in FlutterFlow Studio versions greater than or equal to the version it was last edited in.
To ensure that new versions of libraries used in a pinned project are compatible with a pinned project, we recommend pinning all libraries used in a pinned project to the same (or lower) Flutterflow version as the pinned project.
Library projects can also be pinned to a specific version, ensuring that all library versions use that FlutterFlow Studio release until the pinned version is changed.
FAQs
Can I edit my project in multiple versions of FlutterFlow Studio?
No. If your project is not pinned to a specific version, you’ll always use the latest FlutterFlow Studio release. If your project is pinned to a specific version of FlutterFlow Studio, you will be prompted to edit the project in that version.
How often are new stable versions released?
We aim to release new stable versions of FlutterFlow Studio approximately once a month.
How can I see what’s included in a new stable version?
We’re currently working on displaying release notes directly in the product, so you can easily review what’s been added or changed in each new stable version.
What if there are bugs in the FlutterFlow Studio version I’m using?
If critical bugs arise, we may provide hotfixes or patches for older FlutterFlow Studio versions. However, some fixes depend on updating the underlying Flutter framework or related dependencies, which isn’t always feasible for older versions. This is a risk of staying on an older version of FlutterFlow Studio as opposed to always using the latest.
Can I change the pinned version to be different for various branches in my project?
Yes, you can pin different versions for different branches. We recommend first creating a new branch, updating it to a later version, making any necessary changes, and verifying that everything works as expected before merging it into your main branch.
However, to merge branches successfully, ensure that both the main branch and the new branch are pinned to the same FlutterFlow Studio version.
What happens if there is no stable version available for me to pin my project to?
If your project was created and edited on a standard release that does not correspond to a stable version, you may not see a stable version available. Instead, you can choose to opt-in to the next stable release. If set to the next stable release, a project will immediately be pinned when opened when a new stable release becomes available.
What is the recommended approach if I have multiple projects and libraries that I am working on?
If you choose to pin your project to a stable version of FlutterFlow Studio, we recommend pinning all your projects and dependencies to the same version - and trying to upgrade all projects to the next version around the same time. This makes it easier to ensure compatibilities between projects and libraries that depend on each other. Additionally, this makes it easier to have a single FlutterFlow Studio desktop environment that you are working within.
Last updated on