Cosmic JS Revision History


We've all seen it: You're on the last column of a time-consuming spreadsheet, the last thought in a blog article or putting the last touch on a new press release. You either hit the wrong key and all of your hard work evaporates into thin air or a co-editor is simultaneously editing and overwrites your content changes. You frantically scramble to "Edit Undo" and finally resort to refreshing the page to see if your changes have been saved. Alas, another workflow stretched longer by tools that don't keep up with you and your team in real-time. 


What is Revision History?

Revision History: Or, as I like to call it, the global "CYA" (cover your ass) for all marketers everywhere 😀 Revision history becomes especially important in a cross-functional team environment. When developers and editors are collaborating in a Bucket to manage content, data and files, it helps to have a system that is memorizing every version of your content, in the event that you want to revert back, save drafted content to a published object, retrieve a revision history API endpoint or simply view prior changes. 

With revision history, you no longer have to worry about editing mistakes. You now have the power to go back in time and revert to to prior versions. You can even have multiple editors working on the same piece of content at once and rest assured that you will never write over each other. Hey, even if you did, you have Revision History! (Refer to viewing prior versions below) 😉 


How to Add Revision History to Your Bucket

To add Cosmic JS Revision History to your Bucket, simply navigate to your Bucket > Bucket Settings > Billing:


How To View Prior Versions

Navigate to the Object whose revision history you're querying and click on "Revision History". You can click any of the linked timestamps to access that version of content, revert back to it, or simply make changes to the published content in draft state. 

Once you click into a timestamped version, you'll have the ability to modify content and preview your content just as you would in the live version. Notice the banner at the top alerting you that this is a prior version:



How to Access Your Revision API Endpoint

Navigate to the Object whose revision history endpoint you're querying and click on "Revision Endpoint". Your API endpoint opens in a new tab. Note: only developers and admins have access to the Revision Endpoint. You can toggle to the Editor view to see how only Revision History is an option for that particular role type.


When is Revision History Used?

There are many examples, but here's a few we've seen since releasing the feature:

  • Colleague edits and publishes existing piece of content that needs to be reverted back to original version
  • Team needs multiple versions of the content available via API endpoint for testing
  • Team needs access to change log to see who has been active in content management
  • Editor accidentally erases existing content


Need more peace of mind when managing your team's content? Check out our next powerful feature for editors and developers alike: Automatic Backups


Conclusion

I hope you have found this tutorial on Revision History helpful. If you have any other questions or comments about managing content in Cosmic JS, feel free to Reach out to us on Twitter and join our Slack community.

Was this article helpful?

Thank you! Your input helps us improve our articles and resources. If you have any other questions or comments, please contact support.

You may also like


You have the ability to add Quick Links to Your Cosmic JS Bucket Dashboard. Quick Links are a great way to easily navigate to other websites, shared resource documents, CRMs, task management software or team collaboration tools directly from your Cosmic JS Bucket Dashboard.
Creating a static React App without worrying about language boundaries
All of your images you upload to Cosmic JS are already transformed to imgix URLs, a powerful real-time image processing and CDN delivery solution. Let's take these images to the next level by optimizing image formats, compressing, intelligently cropping, & more!
For simple shopping websites, going with full-fledged solutions like Shopify or Woocommerce can be a total overkill. In this tutorial, we're going to build an e-commerce website using Nuxt and Cosmic JS.
Cosmic JS makes it easy to manage content for your Vue.js applications. In this blog we'll quickstart a Vue.js RPG Adventure Game using the Cosmic CLI. Our game, "Enter The Cosmos", is a turn-based, RPG style game built using Vue.js, Node.js and Cosmic JS.
Cosmic Community Member Reagan McFarland just debuted the new Alexa Skill codebase to add Objects to your Cosmic JS Bucket via voice. In this video, Cosmic JS co-founder Tony Spiro takes you on a quick tour of how to demo the Alexa To Do app from the Alexa developer console.