We use cookies to give you the best experience on our website. If you continue to browse, then you agree to our privacy policy and cookie policy. Image for the cookie policy date
Unfortunately, activation email could not send to your email. Please try again.
Essential JS2

Syncfusion jQuery based widgets are no longer in active development. Switch to our pure JavaScript based next generation Essential JS 2 library.

Syncfusion Feedback

Usage of ej.persistStateVersion property

Platform: jQuery |
Control: ejGrid
Tags: general, common

In certain cases, we may make changes in a control model(application) and thus would like to see the changes getting reflected in the browser view without being conflicted with the previous model. In such cases, ej.persistStateVersion will come in handy.


In detail, let us consider an example where the user renders a grid (with enablePersistence enabled) in page.

Now the user makes some changes in the application level, the grid should reflect the changes made in the grid model.

We have provided the version based storage support such that we invalidate the previously stored data from local storage and the newly stored item will be based on the version specified. We can define this using the ej.persistStateVersion property which accepts a string value. Please refer to the below code example. 


The ej.persistStateVersion is a global variable which is used to reflect the changes that are made to the Syncfusion control model (in application) in the browser.

So, if you would like to ensure the property usage, we suggest you to run your application and make some changes in the layout of the Grid in browser. If you reload the page, you could see the modified changes persisted in grid.  


Then re-run the sample with ej.persistStateVersion defined. In this case, you could see that the changes made in the layout of the grid would have been no more persisted and thus grid will be rendered based on the defined settings. Now, if you make the changes to grid layout and reload the page, the modified changes will be persisted in the grid. 

Note: Whenever you modify the grid model from application, we suggest you to change the ej.persistStateVersion such that it invalidates the previously stored data and render grid based on newly defined model. And, please use the above code only when changing the grid model in application. It is not necessary to use this property when modifying the grid layout in browser view page. 

You must log in to leave a comment

Please sign in to access our KB

This page will automatically be redirected to the sign-in page in 10 seconds.

Up arrow icon

Warning Icon You are using an outdated version of Internet Explorer that may not display all features of this and other websites. Upgrade to Internet Explorer 8 or newer for a better experience.Close Icon

Live Chat Icon For mobile