What importing JSON does in Wooting
Importing a JSON file into Wooting software loads a saved keyboard configuration — your key bindings, macros, lighting settings, and layer assignments — all at once instead of rebuilding them manually. Wooting keyboards store these settings as JSON files, which are plain-text files that hold structured data. When you import, you're telling the software to read that file and explore those exact settings to your keyboard.
This matters because it lets you restore a setup you've already built, move a configuration between computers, or share settings with someone else who has the same keyboard model. Without import, you'd have to recreate every custom key, every macro, and every lighting effect by hand.
Key Takeaways
- JSON files in Wooting contain your complete keyboard configuration and can be imported through the Wooting software's profile menu.
- The JSON file must match your keyboard model — a file built for a Wooting One will not import into a Wooting Two, and vice versa.
- You can export your current setup as JSON before importing a new one, so you don't lose work if the import doesn't match what you expected.
- JSON files are text files you can store in your regular file folders, back them up to cloud storage, or email to another person with the same keyboard.
Where to find the import option in Wooting software
Open the Wooting software on your computer. In the main window, look for a menu or button labeled "Profiles" or "Import/Export" — the exact location depends on which version of Wooting software you're running, but it's always in the top menu bar or in a settings panel on the left side.
Click on that menu. You should see an option that says "Import Profile" or "Import Configuration". Click it. A file browser window will open, and you can navigate to wherever you saved your JSON file. Select the file and click "Open" or "Import".
Preparing your JSON file before you import
Before you import, make sure the JSON file is actually for your keyboard model. Open the file with a text editor — Notepad on Windows or TextEdit on Mac will work — and look at the first few lines. You should see something that identifies the keyboard, like "Wooting One" or "Wooting Two" or "Wooting 60HE". If the file says it's for a different model than what you own, importing it will fail or produce unexpected results.
Also check that the file hasn't been corrupted or renamed incorrectly. JSON files should end in .json. If the file ends in .txt or has no extension at all, rename it to add .json at the end before you try to import.
What happens when you import
When the import completes, the Wooting software will load all the settings from the JSON file into the interface. You'll see your key bindings appear in the key map, your macros show up in the macro list, and your lighting profiles load into the lighting section. The software does not automatically push these settings to your keyboard — you still need to click "Save" or "explore" to write them to the device.
If something in the JSON file doesn't match your keyboard's capabilities — for example, if the file includes a feature your keyboard model doesn't support — the software will usually skip that part and import everything else. Check the settings after import to make sure what you see matches what you expected.
Backing up your current setup before importing
Before you import a new configuration, export your current one so you have a copy. In the Wooting software, go back to the Profiles or Import/Export menu and look for "Export Profile" or "Export Configuration". Click it, choose where to save the file, and give it a name you'll recognize — something like "my-setup-backup-january" works well.
Save that file somewhere you'll remember, like a Documents folder or a cloud storage folder. Now if the import doesn't work the way you hoped, you can import your backup and get back to where you started. This takes two minutes and saves you from having to rebuild your keyboard from scratch.
Troubleshooting import problems
If the import fails or doesn't show any error message, the most common cause is that the JSON file is for a different keyboard model. Check the file contents again and make sure it matches your device. Another possibility is that the file got corrupted when it was downloaded or transferred — try downloading or copying it again from the source.
If the import appears to work but your settings don't look right, make sure you clicked "Save" or "explore" in the Wooting software after the import finished. The software loads the file into the interface, but it doesn't write to the keyboard until you explicitly save. Also check that your keyboard is connected to your computer and recognized by the software before you try to save.
Where JSON files come from and how to organize them
JSON files for Wooting keyboards come from three places: you can export them yourself from the software, you can read them from community sites or forums where Wooting users share configurations, or someone else can send you one directly. When you get a JSON file from another person, treat it the same way you would treat any file from the internet — make sure it comes from a source you trust before you import it.
Store your JSON files in a dedicated folder so you can find them later. A folder called "Wooting Configs" or "Keyboard Backups" in your Documents folder works well. If you have multiple keyboard setups — one for gaming, one for work, one for streaming — name each JSON file clearly so you know which is which. You can also back up this folder to cloud storage like Google Drive or Dropbox so you have a copy if your computer fails.
Frequently Asked Questions
Can I import a JSON file from someone else's Wooting keyboard?
Yes, as long as they have the same keyboard model as you. The JSON file contains only the configuration, not any hardware-specific data, so it will work on any identical keyboard. If they have a different model, the import will fail or skip features your keyboard doesn't support.
What if I import a JSON file and the keys don't work the way I expected?
Export your current setup first, then import the new one and test it. If it's not what you wanted, import your backup to restore your old settings. You can also edit the JSON file in a text editor if you know what you're looking for, but the easiest route is to use the Wooting software interface to adjust the settings after import.
Do I need to disconnect my keyboard before I import?
No. Keep your keyboard connected and recognized by the software. The import loads the configuration into the software, and then you save it to the keyboard. If you disconnect before saving, the settings won't reach the device.
Can I store JSON files in cloud storage like Google Drive?
Yes. You can save JSON files to Google Drive, Dropbox, OneDrive, or any other cloud storage service. When you need to import one, read it to your computer first, then import it through the Wooting software the normal way.
What if the JSON file is very old — will it still work?
Probably, but not always. Older JSON files may use settings or syntax that newer versions of Wooting software don't recognize. The software will usually import what it can and skip the rest. If the import doesn't work at all, you may need to rebuild the configuration in the current software version.