Cloud Saves

Enable and test Cloud Save for your product

3 mins to read

Overview

The Cloud Save feature enables users to continue their game progress whenever and wherever they play next by automatically storing their save files in the cloud. This guide covers how to set up Cloud Save for your product and provides test cases to ensure the feature is working as expected.

Enable Cloud Save for your Product

Cloud Save is enabled at the base product offer level. To get started, follow the steps below:

  1. In the Dev Portal, navigate to Your Product > Epic Games Store > Offers and select your base product offer from the list.
  2. On the Offer Details page, click Cloud Save.
  3. On the Cloud Save page, activate the Enable Cloud Save toggle.
  4. Enter location information for where games are saved locally on users’ PC and Mac devices, as appropriate.
  5. Complete the Files to Sync section as needed to customize file quotes and sync rules for cloud saves.
  6. Review the entered information, then click Save Changes.

Cloud Save Test Cases

To ensure Cloud Save is working optimally for your product, conduct the following Cloud Save test cases. Instructions and expected results are provided for each scenario.

Before You Begin

As Cloud Save is an opt-in feature for end-users, ensure it has been enabled in your Epic Games Launcher before you begin testing. While Cloud Save is typically enabled by default for installed games, it is recommended that you confirm the setting has been enabled to avoid any issues.

To do so, follow the steps outlined in the Epic Games online support article, Enable Cloud Saves in the Epic Games Launcher

Testing Sync to Local Storage

Steps

  1. Install your product.
  2. Open the Epic Games Launcher and launch your game.
  3. Play until a save point is created.
  4. Close the game. The Launcher should now sync the cloud save.
  5. Complete one of these options:
    • Delete the local save files and the cloud save .manifest files. The manifest filepath is: C:\Users\<UserName>\AppData\Local\EpicGamesLauncher\Saved\Saves\<EpicAccountID>\<ArtifactID>\
    • Install your product on a different machine.
  6. Re-launch your game.

Expected Results

  • Successful launch without any cloud save issues
  • No save conflict screens display
  • User has correct local save files (determined by last save point synced to the cloud)

Testing for Save Conflicts

Steps

  1. Install your product.
  2. Open the Epic Games Launcher and launch your game.
  3. Play until a save point is created.
  4. Close the game.
  5. In the Epic Games Launcher, disable Cloud Saves.
  6. Re-launch your game.
  7. Play until a new save point is reached.
  8. Close the game.
  9. In the Epic Games Launcher, enable Cloud Saves.
  10. Re-launch your game.

Expected Results

  • The cloud sync conflict screen displays
The cloud sync conflict screen

Cloud Save Error Codes

Potential error scenarios and their codes are listed below. If you require additional assistance with any issue not listed here, create a private discussion on our Developer Support site.

ErrorTitleDescription
CS-UL (Upload Fail)Connection ErrorWe are unable to connect to our servers. Please check your network setup and try again.
CS-02 (Failed to chunk save directory)Cloud Save Backup ErrorWe had some problems accessing the game's save files. Please check that the game is not running and save files are not open by another process.
CS-03 (Upload size too large)Data SizeThe save files are too large to upload. Note: Epic Games Store cloud saves have a baseline sync value of 1GB. Try increasing the Max sync quota.
CI-03 (Failed to load manifest)Install ErrorFailed to install Cloud Save. Please check available disk space.