anchor.diff:  ---
  -title: Revisions
  +title: App Revisions
   owner: CAPI
   ---
   
  -This topic describes revisions and how you can use them. 
  +This topic describes app revisions and provides procedures for working with them. 
  +
  +For additional information, see the _Revisions_ section of the [CAPI documentation](http://v3-apidocs.cloudfoundry.org/version/release-candidate/#revisions). 
   
   ## <a id="enable"></a> Overview
   
   A revision represents code and configuration used by an app at a specific time. It is a Cloud Foundry API (CAPI) object that can contain references to a droplet, custom start command, and environment variables. The most recent revision for a running app represents code and configuration currently running in Cloud Foundry.
   
  -Some use cases for Revisions include:
  +Some use cases for revisions include:
   
   * **Viewing revisions for an app**: This can help you understand how your app has changed over time. 
   * **Rolling back to a previous revision**: This allows you to deploy a version of the app that you had running previously without needing to track that previous state yourself or have multiple apps running. When you create a deployment and reference a revision, the revision deploys as the current version of your app.
  
positive.code: 	}'
  	```
  	Where:
  	* `REVISION-GUID` is the GUID of the Revision. 
  	* `APP-GUID` is the GUID of the app. 
  
  ## <a id="view"></a> Add Metadata to a Revision
  
negative.code: * A new droplet is created for an app
  * An app’s environment variables are changed
  * The custom start command for an app is added or changed
  * An app rolls back to a prior revision
  
  By default, the Cloud Foundry API retains at most 100 revisions per app.
  
  ### <a id="revision-description"></a> Revision Descriptions
  
  Each revision includes a description of what changed in your app at the time the revision was created. The description includes one or more of the following:
  
  * `Process type removed`
  * `New process type added`
  