Move Over, JavaScript Buttons and Make Room for the Lightning Experience Configuration Converter!


By now you have heard us talk a lot about Lightning. And, with the Lightning Experience Migration Assistant you have started down the path of checking your readiness, previewing your orgs, and even turning on Lightning for a group of users.

But, you have one last lingering hang-up about it all. JavaScript buttons. JavaScript buttons and links are types of actions in the Salesforce Classic UI. They allow you to create inline JavaScript code that can be invoked via a button or link embedded on a record or list page. Sure, you have been using them for years in Salesforce Classic and they served you well. But, let’s be honest— they are getting in the way of your move to Lightning Experience.

Fear not! Like that friend with a magical UHF to VHF converter, the Lightning Experience Configuration Converter can help make your transition easier. With just a few clicks, this new tool scans your org for simple JavaScript buttons, converts them to point-and-click alternatives, and then deploys everything right to your org.

Let us just pause for moment, because I think this might be your reaction!


The Lightning Experience Configuration Converter recreates your org’s JavaScript buttons as Lightning components, quick actions, or other declarative solutions, without touching your original buttons. Before committing to any changes, you can preview the new component code or declarative steps and verify the alternatives work as expected.

This tool currently converts some (but not all) JavaScript buttons that implement “url-hacks.” (If you’re not familiar with the term, a “url-hack” is how the community refers to a URL that sets predefined values). This is the most common use case for JavaScript buttons. The Configuration Converter recreates these buttons as either quick actions, Lightning component actions, or custom buttons or links, based on what the JavaScript code is doing. JavaScript buttons can have varying degrees of complexity. Currently, the tool supports simpler “url-hack” implementations.

Let’s take for example, a JavaScript button that opens an external url to: and has the JavaScript code: (“”).

With Lightning Experience Configuration Converter it will create a “Detail Page Button” which opens “”

Here’s another example of a JavaScript-based “url-hack” that edits a record and sets a predefined value for a field: The JavaScript Code is: location.replace(“/0016A00000MlPFl/e?00N6A00000IF4Mo=MyValue”).

With Lightning Experience Configuration Converter it will create a Lightning Component Action that edits the record and sets the field with ID 00N6A00000IF4Mo with value “MyValue.”

How do you get started with the Lighting Experience Configuration Converter? Glad you asked. Visit Lightning Experience Configuration Converter and log in with your sandbox or Developer Edition org credentials.

Under Settings, list the objects that you want to scan for JavaScript buttons. For performance and manageability, we suggest you scan one object at a time.

Click Refresh Buttons.

Select Convert to recreate detected JavaScript buttons or Convert and Deploy to recreate detected JavaScript buttons and add the new Lightning alternatives to page layouts.
Thoroughly test the changes before deploying to your production org.

So, what do you say? Are you ready to embrace the efficiency of the Lightning Configuration Converter? Get started by logging in to Lightning Experience Configuration Converter with your sandbox or Developer Edition org credentials. Don’t forget to learn more about this topic with Trailhead, in the module below.

Additional Links:

Lightning Experience Configuration Converter Help (Live June 6th, 2018)

Introducing Sample Components for Lightning Component Actions

Sample Lightning Component Actions Github repository

Lightning Alternatives to Javascript webinar

Lighting Now! Trailblazer community group

Trailhead Resource
Discover Lightning-friendly solutions for your JavaScript button use cases.
Sandboxes vs. Scratch Orgs and How to Use Them

Sandboxes vs. Scratch Orgs and How to Use Them

A best practice for building and configuring new solutions is to always build and test outside of your production org. But what org type should you use for building and testing? There are many resources that break down sandboxes and scratch orgs separately—but on the Admin Relations team, we often hear from admins who want […]

Release Highlights for Admins

Release Highlights for Admins | Learn MOAR Spring ’23

Join us and discover the new Spring ’23 release features for admins and developers. We know each release brings with it lots of amazing new functionality and there can be a lot to digest. With Learn MOAR, we’re packaging the release and bringing it to you in an easy-to-digest format with blogs, videos, and more. […]

Cloudy standing under text that says "5 Data Management Labs Apps for Admins."

5 Data Management Labs Apps for Admins

Data management is crucial to keeping records organized and easily accessible, and to having the information needed to respond to your customers’ needs. In our connected world, it’s become more important than ever to provide personalized experiences for your customers—and having the right data is key. Luckily, AppExchange and Salesforce Labs are here to help. […]


Have an Idea for a Story?

We are all about the community and sharing ideas.
Do you have an interesting idea or useful tip that you want to share?