Hi Developers!
Today we’re fully releasing Shorelines out of Beta! We thank you all for your feedback, messages, and details that helped us stabilize this feature. Shorelines allow water to smoothly hug the shores, its edges being unconstrained by voxel vertices and able to freely animate following the waves. 
Before the upgrade (left), After the upgrade (right)
Shorelines work by allowing a terrain voxel to contain both water and another terrain material. We also extend the water surface’s geometry past the actual shore, to allow for a smooth connection.
Important note
We will be deprecating the old water shores because we can’t maintain that system together with Shorelines. We’ll share more details on the old water deprecation steps and timeline soon.
We recommend upgrading your place as soon as possible, especially if you are using water with other terrain materials, so you can make sure it looks good to you or make any modifications you need.
How to upgrade
New places
All Roblox Studio place templates were upgraded to Shorelines and there are no steps needed to benefit from improved water shores in new places.
Existing places
If you wish to improve your shores in an existing place, you will have to upgrade your terrain with Shorelines. The Shorelines upgrade is applied per-place, so if you own multiple places, note that you’ll have to upgrade each of them individually.
NOTE: This upgrade can impact the look of your water shores. You can find more details in our warnings below.
- Please make a backup/copy of your place. The upgrade cannot be reverted after you save your place.
- Open a place that you have previously backed up.
- Go to Terrain Editor > “Create” tab > “Upgrade Shorelines” dropdown > “Upgrade” button. You will then see a loading bar indicating how the upgrade process is going.
When the process completes, you’re done! Enjoy the Shorelines Upgrade! 
Warnings
Warning #1: Edits post-upgrade are expected
Shorelines improves the look of water, but it changes the water’s behavior when it meets with other terrain materials. Proceeding with the upgrade might change your place’s water bounds.
Most simple cases will be handled seamlessly, but you might need to edit your terrain after the upgrade for water to match back with your original intention. Streams, waterfalls, non-horizontal water surfaces, and workarounds to the old water system are likely to require some edits.
Tip: If you built workarounds to the old water system to get better looking shores, such as manually reshaping shorelines or inserting parts to hide the artifacts, you may get better results by removing the workarounds before upgrading.
Warning #2: You cannot revert the upgrade once it’s saved
After proceeding with the upgrade you will be able to undo it with the usual “undo” commands (the button, ctrl+z, or command+z). However, we don’t provide a revert functionality for Shorelines. Once you have saved your place, you will only be able to revert the upgrade using your place’s Version History. This is why we recommend that you make a backup of your place before trying Shorelines.
Scripting Water with Shorelines
If you’re interested in scripting your voxels once you’ve done the Shorelines upgrade, check out the Read/WriteVoxelChannels API we released specifically for that.
Made with love
Shorelines was achieved with the remarkable contributions of @Hyperhumanist, @ProtoValence, @RickleSandwich, @Neutrinostack, @wcai_rblx, @IgnisRBX, @PixelMiner47, @RBLXImagineer and @JoshSedai. Thanks for your help and support in making Shorelines! 
We’re super excited to hear your thoughts on Shorelines! Let us know about your experience and if you encounter any issues!
.)