How to update the URL without page reload in JavaScript

HTML5 History API provides pushState() and replaceState() methods that are used to add and modify the browser history records without reloading the page, respectively.

Note that the History API only allows updating same-origin URLs. You cannot use it to navigate to a completely different website.

pushState() method

The pushState() method updates the URL and creates a new entry in the browser history without page reload.

Here is how it looks like:

history.pushState(state, title, url);

The state is an object containing some data related to the new URL. It can be retrieved using JavaScript history.state property.

The title is the new page title that the browser should display. However, it is sometimes completely ignored by the browser.

Finally, the url is the new URL you want to add to the browser history without reloading the page.

Here is an example:

history.pushState({
    id: 'about-me',
    source: 'web'
}, 'About me', 'https://attacomsian.com');

replaceState() method

The replaceState() is another method that updates the URL without reloading the page. It works exactly the same way as pushState(), but replaces the existing browser history entry instead of adding a new one.

Ideally, you should use this method only when you want to change the URL without leaving any trace in browser history:

history.replaceState({
    id: 'JavaScript Tutorials',
    source: 'web'
}, 'All JavaScript Tutorials', 'https://attacomsian.com/topics/javascript');

✌️ Like this article? Follow me on Twitter and LinkedIn. You can also subscribe to RSS Feed.

You might also like...

Digital Ocean

The simplest cloud platform for developers & teams. Start with a $200 free credit.

Buy me a coffee ☕

If you enjoy reading my articles and want to help me out paying bills, please consider buying me a coffee ($5) or two ($10). I will be highly grateful to you ✌️

Enter the number of coffees below:

✨ Learn to build modern web applications using JavaScript and Spring Boot

I started this blog as a place to share everything I have learned in the last decade. I write about modern JavaScript, Node.js, Spring Boot, core Java, RESTful APIs, and all things web development.

The newsletter is sent every week and includes early access to clear, concise, and easy-to-follow tutorials, and other stuff I think you'd enjoy! No spam ever, unsubscribe at any time.