Skip to content

StringFormatter

James edited this page Dec 5, 2025 · 3 revisions

String Formatter Commands

The String Formatter is used to format strings in the build task. It supports commands that can be used to insert values into the string.

The following commands are available:

  • {buildArchitecture}: Which architecture the build will be (eg x64/x84)
  • {buildName}: The name of the build as specified in a build config.
  • {buildNumber}: A unique number of the build that is produced.
  • {buildTarget}: Which platform targeting for the next build as defined in Build Settings.
  • {buildTargetGroup}: The target group of the upcoming build as defined in Player Settings.
  • {bundleVersion}: The version of your project for android/ios as specified in Player Settings.
  • {cacheFolderPath}: The path where all files and builds are stored when build uploader is working.
  • {companyName}: The name of your company as specified in Player Settings.
  • {date}: The current local date in the format YYYY-MM-DD.
  • {dateTime}: The current local date and time in the format YYYY-MM-DD HH-MM-SS.
  • {destLocalPath}: The path which files will be copied to using the LocalPath destination.
  • {epicgamesArtifactName}: The name of the artifact that is being uploaded to on Epic Games.
  • {epicgamesOrganizationName}: The name of the organization that owns the product on Epic Games that will receive the files.
  • {epicgamesProductName}: The name of the product that is being uploaded to on Epic Games.
  • {itchioChannelName}: The channels/platforms that we are uploading to on Itchio.
  • {itchioGameName}: The name of the game that is being uploaded to on Itchio.
  • {itchioUserName}: The name of the user that owns the game that we want to upload the files to on Itchio.
  • {machineName}: The name of the machine running the build.
  • {persistentDataPath}: The path of the Persistent Data folder
  • {productName}: The name of your product as specified in Player Settings.
  • {projectPath}: The path of your Unity Project contains the Assets folder.
  • {scriptingBackend}: The scripting backend for the next build as defined in Player Settings.
  • {steamAppName}: The name of the app that is being uploaded to on Steamworks.
  • {steamBranchName}: The name of the branch that we are uploading to on Steamworks.
  • {steamDepotName}: The name of the depots that are being uploaded to on Steamworks.
  • {taskDescription}: The description of the current task being executed.
  • {taskFailedReasons}: Gets the reasons why the task failed to upload all destinations.
  • {taskProfileName}: The name of the upload profile or task specified when creating the task.
  • {time}: The current local time in the format HH-MM-SS.
  • {unityVersion}: The version of Unity you are using.
  • {uploadNumber}: A unique number of the upload task that's getting sources and uploading them.
  • {version}: The version of your project as specified in Player Settings.
  • {versionMajor}: The version of your project as specified in Player Settings but only the major segment. eg: a1 from a1.2.3-beta1
  • {versionMajorSem}: The major segment of the version of your project as specified in Player Settings but with only numbers. eg: 1 from a1.2.3-beta1
  • {versionMinor}: The version of your project as specified in Player Settings but only the minor segment. eg: 2 from a1.2.3-beta1
  • {versionMinorSem}: The minor segment of the version of your project as specified in Player Settings but with only numbers. eg: 2 from a1.2.3-beta1
  • {versionPatch}: The version of your project as specified in Player Settings but only the patch segment. eg: 3 from a1.2.3-beta1
  • {versionPatchSem}: The patch segment of the version of your project as specified in Player Settings but with only numbers. eg: 3 from a1.2.3-beta1
  • {versionRevision}: The version of your project as specified in Player Settings but only the revision segment. eg: beta1 from a1.2.3-beta1
  • {versionRevisionSem}: The revision segment of the version of your project as specified in Player Settings but with only numbers. eg: 1 from a1.2.3-beta1
  • {versionSem}: The version of your project as specified in Player Settings but with only numbers. eg: 1.2.3 from a1.2.3-beta1

Clone this wiki locally