An INI file stores settings for a program in plain text that both humans and software can read

An INI file is a simple text document that holds configuration settings — things like window size, color preferences, login information, or which features are turned on. The name comes from the file extension: .ini, short for "initialization". When you install a program and adjust its settings, those changes often get saved into an INI file so the program remembers them the next time you open it.

INI files are organized into sections marked by labels in square brackets, with individual settings listed underneath. For example, a media player's INI file might have a [Display] section containing the window width and height, and a [Playback] section with volume level and whether subtitles are on. Because INI files are plain text, you can open one in Notepad and read or edit the settings directly — no special software required.

Most programs create and manage their own INI files automatically. You do not need to touch them. But if a program crashes, refuses to remember your preferences, or stores a setting you cannot change through the normal menu, the INI file is often where the answer lives.

Key Takeaways

  • INI files are plain-text documents that store program settings and preferences, organized into labeled sections with individual settings listed below each one.
  • You can open and edit an INI file with Notepad or any text editor, making it useful when a program's menu does not offer the setting you need.
  • Most programs create and manage their INI files automatically, so you rarely need to interact with them unless something is broken or stuck.
  • INI files are usually stored in the program's folder or in your user profile's AppData directory on Windows, or the Library folder on Mac.
  • Changing an INI file directly can fix problems like forgotten passwords, corrupted settings, or features that will not turn off through the normal interface.

Where INI files live on your computer

On Windows, INI files are usually stored in one of two places. Some programs keep them in their own folder — for example, in C:\Program Files\ProgramName or C:\Program Files (x86)\ProgramName. Others store them in your user profile under C:\Users\YourUsername\AppData\Roaming or C:\Users\YourUsername\AppData\Local. The AppData folder is hidden by default, so you may need to show hidden files to see it.

On Mac, INI files are typically in ~/Library/Preferences or ~/Library/Application Support, where the tilde (~) represents your home folder. Like Windows, the Library folder is hidden, so you will need to unhide it first. You can do this by pressing Command+Shift+Period while a Finder window is open.

The exact location depends on the program. If you cannot find an INI file, check the program's documentation or support page — they usually list where settings are stored. Some modern programs have moved away from INI files entirely and use other formats like JSON or XML, but INI files remain common in older software and many utilities.

How to open and read an INI file

Opening an INI file is straightforward. Right-click the file, select Open with, and choose Notepad (on Windows) or TextEdit (on Mac). The file will open as plain text, and you will see the sections and settings laid out in a readable format. Each line typically shows a setting name, an equals sign, and the value — for example, volume=75 or theme=dark.

Before you edit anything, make a backup copy of the INI file. Right-click it, select Copy, then right-click in the same folder and select Paste. This creates a duplicate with a name like filename - Copy.ini. If your edits break something, you can delete the broken version and rename the backup back to the original name.

Once you have made a backup, you can open the original in Notepad and look for the setting you want to change. Settings are usually labeled clearly — autostart=true, window_width=1024, or last_user=john. Change the value, save the file (Ctrl+S on Windows, Command+S on Mac), and close it. The next time you open the program, it should use the new setting.

Common reasons to edit an INI file directly

Most of the time, you will never need to edit an INI file. But there are situations where it becomes necessary. If a program crashes every time it starts, the problem might be a corrupted setting in the INI file. Deleting or resetting that file often fixes the crash. If a program remembers your login but you want to clear it for security reasons, the INI file is where that information is stored — you can delete the relevant line and the program will forget it.

Sometimes a program's menu does not offer a setting you need. For example, you might want to change the default window size, the number of recent files shown, or whether a feature is enabled. If the menu has no option for it, the INI file might. You can also use an INI file to turn off a feature that the program will not let you disable through the normal interface — useful if something is broken or behaving unexpectedly.

Another common reason is to transfer settings between computers. If you have configured a program exactly how you like it, you can copy its INI file to the same location on another computer, and the new installation will inherit all your preferences. This saves time when setting up multiple machines or moving to a new computer.

What can go wrong when editing an INI file

The biggest risk is introducing a typo or syntax error that breaks the file. If you change volume=75 to volume=75a (adding a letter by accident), the program may not understand the setting and either ignore it or crash. Always double-check your edits before saving, and make sure you do not accidentally delete a section header or change the structure of the file.

Another mistake is editing an INI file while the program is running. Many programs reload their settings from the INI file only when they start up. If you edit the file while the program is open, your changes may be overwritten when the program closes and writes its current settings back to the file. Always close the program first, edit the INI file, save it, and then reopen the program.

If something goes wrong after you edit an INI file, the fix is simple: close the program, delete the edited INI file, and restore the backup copy you made earlier. Rename the backup to the original filename, and the program will use the old settings. This is why making a backup before any edit is so important.

INI files versus other configuration formats

INI files have been around since the early days of Windows and remain popular because they are simple and human-readable. However, newer programs often use other formats. JSON files are more structured and better at handling complex data. XML files are similar but use a tag-based format. YAML files are designed to be even more readable than INI files. Some programs use proprietary binary formats that cannot be edited as plain text at all.

The advantage of INI files is that anyone can open and edit them with a basic text editor. The disadvantage is that they are not as flexible as newer formats — they work well for simple key-value pairs but struggle with nested data or lists. Despite this, INI files remain common in Windows utilities, older software, and configuration files for servers and applications.

If you are looking at a configuration file and are not sure what format it is, check the file extension. .ini means INI format. .json means JSON. .xml means XML. If the file has no extension or you cannot open it as plain text, it is probably a binary format and you should not try to edit it directly.

Frequently Asked Questions

Can I delete an INI file and will the program recreate it?

Yes. Most programs check for their INI file when they start, and if it is missing, they create a new one with default settings. This is a useful way to reset a program to its original state if settings have become corrupted. The program will lose any customizations you made, but it will work again.

Is it safe to edit an INI file?

It is safe if you make a backup first and close the program before editing. The main risk is introducing a typo that breaks the file. If that happens, you restore the backup and try again. Do not edit an INI file while the program is running, because the program may overwrite your changes.

What if I cannot find the INI file for my program?

Some modern programs do not use INI files at all — they use JSON, XML, or store settings in a database instead. Check the program's documentation or support page to see where settings are stored. You can also search your computer for the filename — for example, search for "config.ini" or the program name plus ".ini".

Can I copy an INI file from one computer to another?

Yes. If you have configured a program on one computer and want the same settings on another, copy the INI file to the same location on the second computer. This works best when both computers have the same version of the program installed. Different versions may use different settings, which could cause problems.

What does the equals sign in an INI file mean?

The equals sign separates the setting name from its value. For example, in theme=dark, "theme" is the setting name and "dark" is the value. When you edit an INI file, keep the equals sign in place and change only the value (the part after the equals sign), unless you know exactly what you are doing.