Salesforce Release/Change Management and Org Documentation [Tools]

Posted February 10th, 2011 in Tips & Tricks by John Coppedge

After a very lengthy discussion on Linked In, I’ve gathered a few points managing change and documenting your Salesforce org:


1. Configuration Workbook for Org Documentation

Download Sample: Download Configuration Workbook

Typically a resource for consultants, but can easily be repurposed for ongoing documentation of your Salesforce org.  The challenge is that the document must be updated with each configuration change in a single centralized location (read: Content, Google Docs, Sharepoint).

2. Exact Metadata for Org Field Documentation

This is one of my favorite methods, as you can extract all objects/fields very easily.  Since the tools pull live data, there is no questioning if the documentation is up to date.  These tools are free, but will only describe field and object info; you’ll need to look elsewhere for documenting workflow, triggers, etc.

Also, I searched long and hard for a tool that will extract the description for each field from the metadata, and couldn’t find one.  My understanding is that the metadata API cannot access the description, yet I can see it through the IDE… which uses the metadata API…?  If you can shed some light on this one please leave a comment!

A. Cloud Converter: http://appexchange.salesforce.com/listingDetail?listingId=a0N300000016cVIEAY

Click a button and extract all metadata from your org into a single excel workbook.  Brilliant.

B. Object Metadata Snapshot Tool: http://appexchange.salesforce.com/listingDetail?listingId=a0N30000003Ih3aEAC

This one is neat, because actually creates records for each field/object.  This means that you can then take an analytic snapshot to create a ‘Point in Time’ view of your Salesforce metadata on a regular interval without any intervention.  Who wouldn’t want a self-documenting org?

C. Etherios EasyDescribe: http://appexchange.salesforce.com/listingDetail?listingId=a0N300000018leZEAQ

3. Snapshot for Org Documentation and Change Management

More info: http://www.dreamfactory.com/solutions/snapshot/

Snapshot is a paid (and not inexpensive) tool for org management.  It take a snapshot of an org configuration, roll-back to a snapshot, transfer configuration changes org to org, and perform a variety of sophisticated functions.  I haven’t personally used the tool but have seen a demo, and it appears to be much more feature-rich than the above metadata tools or change sets.

4. Change Management App: ChangeIt!

Download: http://appexchange.salesforce.com/listingDetail?listingId=a0N300000016ct3EAA

A free, fairly simple app for managing change requests.  By default is a stand-alone package (not linked to other Salesforce objects).

5. Product Management App

Download: http://appexchange.salesforce.com/listingDetail?listingId=a0N300000016c6UEAQ

A free, fairly simple app for product release management.  Has been tailored by default to connect to cases and opportunities.

6. Force.com IDE

You can use the IDE to extract virtually all information about your Salesforce org.  Note that the IDE is a developer tool and will return information in a programtic fashion (XML), not easily accessible spreadsheets like the above metadata tools.  It can be combined with Subversion for version control.



7. View Setup Audit Trail

From within Salesforce: Administration Setup –> Security Controls –> View Setup Audit Trail

When all else fails, read the log Smile


This is by no means a comprehensive list.  Please leave a comment below if you have a favorite tool not mentioned above!




11 Responses so far.

  1. […] This post was mentioned on Twitter by Jeff Douglas and John Coppedge, Michael Gill. Michael Gill said: RT @johncoppedge: New post: Salesforce Release/Change Management and Org Documentation [Tools] http://bit.ly/esi801 #in […]

  2. Vishwas KarhadeNo Gravatar says:

    I would like to add ‘Zen – Integrated requirement and Quality Cloud’ App in this list


    It is paid App but free for Non profit organizations

  3. Tammy VoseNo Gravatar says:

    Thanks for putting this together John!!

  4. Jack JohnsonNo Gravatar says:

    Where on Linkedin?

  5. toolbar ieNo Gravatar says:

    Excellent read, I just passed this onto a friend who was doing a little research on that. And he actually bought me lunch since I found it for him smile Thus let me rephrase that: Thank you for lunch!

  6. Hannes EllerbrockNo Gravatar says:

    I would like to add “StratoSource” to this list. It’s not directly doing release management, but does a great job automatically backing up your configuration.
    By then writing the configuration into a Git repo, you can easily determine changes that were made.
    As it is open source, one could add the functionality for deployment into the tool.

  7. Tammy VoseNo Gravatar says:

    John, working on a new org that is 10 years old and we are undertaking a cleanup effort. I would now like to extract the metadata related to profiles (we have 80 – yikes) so that we can compare profiles within a spreadsheet. Any ideas how we might achieve this?

  8. John CoppedgeNo Gravatar says:

    Hey Tammy,

    That is an interesting one – I don’t know off hand. It looks like you can extract the permissions (user and general) via the data loader. You may need to resort to using the profile views to capture the object permissions.

  9. NiranjanNo Gravatar says:

    RABIT Force is a comprehensive release management framework from Lemtom specifically designed for Salesforce Applications . Automated Meta Data Packaging , Sandbox deployments and promotions , automated test integration , Version Control support along with most powerful advanced dataloader all built into single framework of RABITForce .
    RABIT stands for Rapid Automated Build Install Test Framework from Lemtom. There is a free trial. You can include it if you think it makes sense.

  10. John CoppedgeNo Gravatar says:


    Neat concept. The website and demo video don’t communicate the message of the product very effectively, however.

    I wish your team success, definitely something I could use myself!



Leave a Reply