Scrolling sideways to read a single line of text is nobody’s idea of a good time.
If you work with log files, plain text documents, or HTML in Notepad++, long lines that run off the screen slow you down. Learning how to wrap text in Notepad++ fixes that instantly, with no changes to the actual file content.
This guide covers every method available, from the one-click View menu toggle to keyboard shortcuts, permanent settings via config.xml, fixed-column hard wrap using the TextFX plugin, and common troubleshooting fixes when word wrap stops working.
What Is Text Wrapping in Notepad++

Word wrap in Notepad++ is a display-only setting that fits long lines within the visible editor window without inserting any actual line breaks into the file.
The file content stays unchanged. What changes is how Notepad++ renders lines on screen. A 500-character line stays a single line in the file, but appears as multiple visual rows in the editor.
By default, word wrap is off in Notepad++. Long lines extend horizontally, forcing you to scroll sideways to read them. That’s fine for code. For log files, plain text, HTML, or Markdown, it gets old fast.
Notepad++ was first released in 2003 by Don Ho and was voted the most-used text editor worldwide in the 2015 Stack Overflow Developer Survey, with 34.7% of over 26,000 developers reporting daily use (Stack Overflow).
| Wrap Type | Changes File Content | Best For |
|---|---|---|
| Soft wrap (word wrap) | No | Reading, plain text, logs |
| Hard wrap (line break) | Yes | Fixed-width output, email formatting |
Most users need soft wrap. Hard wrap is only relevant when you need actual line breaks inserted into the file at a fixed column, like when preparing text for email clients or terminal output.
What File Types Benefit Most from Word Wrap
Common use cases:
- Log files with long event strings
- Plain text documents and notes
- HTML files with inline attributes
- Markdown files and README drafts
- CSV files viewed without a dedicated tool
Source code is a different story. Most developers leave word wrap off for code because wrapping mid-statement breaks visual alignment and makes indentation hard to follow.
How to Enable Word Wrap in Notepad++ Using the Menu

The fastest route: open Notepad++, go to View in the menu bar, and click Word wrap. That’s it. One click toggles it on. The same path toggles it off.
After enabling, all open tabs wrap to the current window width. No file is modified. Resize the window and the wrapping adjusts automatically.
Step-by-Step Menu Path
To enable word wrap via menu:
- Open Notepad++ and load your file
- Click View in the top menu bar
- Click Word wrap in the dropdown
- Lines now wrap to fit the editor window
A checkmark appears next to “Word wrap” in the View menu when active. No restart needed. The setting applies immediately across all open documents.
Toolbar Icon Shortcut
There is also a toolbar icon that toggles word wrap directly, located to the left of the paragraph mark (¶) icon in the default toolbar.
This is worth knowing because that icon is easy to click accidentally. If word wrap keeps toggling off unexpectedly, the toolbar icon is usually the reason. A plugin called Customize Toolbar lets you remove it if it causes problems.
How to Enable Word Wrap in Notepad++ Using a Keyboard Shortcut

Notepad++ does not assign a single default hotkey to word wrap out of the box. There is no built-in keyboard shortcut like Ctrl+W or Alt+W waiting for you by default.
What you can do is assign one yourself through the Shortcut Mapper, or use a macro to record the toggle action and bind that macro to a key combination.
How to Assign a Custom Shortcut to Word Wrap
Via Shortcut Mapper:
- Go to Settings in the menu bar
- Click Shortcut Mapper
- In the Main menu tab, search for “Word wrap”
- Double-click the entry and assign your preferred key combination
- Click OK and close
A combination like Ctrl + Shift + W works well and doesn’t conflict with default Notepad++ bindings. Check the Shortcut Mapper first to confirm there’s no conflict before assigning.
How to Create a Macro Shortcut for Word Wrap
Macro recording method:
- Go to Macro > Start Recording
- Navigate to View and click Word wrap to toggle it
- Go to Macro > Stop Recording
- Select Save Current Recorded Macro and name it
- Go to Settings > Shortcut Mapper, find your macro, and assign a key
This is actually a cleaner approach than mapping the menu action directly, because the macro can be given a descriptive name and reused across sessions.
How to Make Word Wrap Permanent in Notepad++

In most Notepad++ installations, word wrap state is saved automatically between sessions. Set it once, close the editor, reopen it and the setting persists. That’s the expected behavior.
But a known bug in versions 8.4.6 through 8.4.8 caused word wrap to reset on restart when using the installer version (GitHub, 2023). If you’re on an older build, updating to the current release fixes this.
Where the Setting Is Stored
The word wrap state is stored in config.xml, located in your Notepad++ application data folder (usually %AppData%Notepad++).
The relevant line looks like this:
“ Wrap="yes" `
Changing Wrap=”no” to Wrap=”yes” manually and saving the file forces word wrap on even if the UI toggle isn't working. Close Notepad++ before editing config.xml, or the file will be overwritten on exit.
Why Word Wrap Resets After Restart
3 common causes of word wrap not saving:
- Portable mode: config.xml sits in the install folder and requires write permissions to that folder
- Read-only config: if config.xml is marked read-only or the folder is write-protected, changes don’t save
- Accidental toggling: clicking the toolbar icon without realizing it turns wrap off before Notepad++ closes
The Notepad++ community forum has tracked the accidental-toolbar-click issue since at least v8.6.4 (2024). Removing the word wrap icon from the toolbar via the Customize Toolbar plugin is the cleanest fix if it keeps happening.
How to Set Word Wrap for Specific Languages or File Types
Notepad++ does not support per-language word wrap settings natively. The word wrap toggle is global. It applies to all open documents across all language profiles simultaneously.
This is a long-standing feature request in the Notepad++ GitHub repository. For now, per-file word wrap requires a workaround.
Python Script Plugin Workaround

The Python Script plugin can apply word wrap selectively based on file extension or buffer ID. A community-developed script registers a callback that fires every time you open or switch documents, then checks whether the current file should have word wrap on or off.
Setup steps:
- Install Python Script via Plugins > Plugins Admin
- Create a script that checks the file extension of the active document
- Set the script to run on startup via the user startup script
The script does not survive a restart by default unless you configure it to run at startup. The Notepad++ community forum has a maintained thread with a persistent version of this script (community.notepad-plus-plus.org, 2024).
Session-Based Workaround
Simpler approach for mixed workflows:
- Save separate Notepad++ sessions for different file types
- One session with word wrap on (text/log files)
- One session with word wrap off (code files)
Load the relevant session when switching between file types. Not elegant, but it works without any scripting.
How to Wrap Text at a Specific Column Width in Notepad++

Native word wrap in Notepad++ wraps lines to the current window width, not a fixed column number. There is no built-in setting to say “wrap at column 80” with soft wrap.
For fixed-column wrapping, you have 2 options: use a visual guide with the Edge Line feature, or use a plugin or regex to insert hard line breaks at a specific column.
| Method | Changes File | Fixed Column | Tool Required |
|---|---|---|---|
| Native word wrap | No | No (window width) | None |
| Edge Line guide | No | Visual only | None |
| TextFX ReWrap | Yes | Yes (clipboard value) | TextFX plugin |
| Python Script rewrap | Yes | Yes (prompt input) | Python Script plugin |
Setting a Visual Column Guide with Edge Line
The Edge Line feature draws a vertical line at a specified column. It doesn’t wrap anything. But it gives you a visual target to manually resize the window against so soft wrap lands at roughly the right column.
To enable Edge Line:
- Go to Settings > Preferences > Editing
- Check Show vertical edge
- Choose Line mode and set the column number (80 is standard for code)
- Click Close
Resize the Notepad++ window until soft-wrapped lines align with the edge line. This takes some manual adjustment but requires no plugins.
Hard-Wrapping Text at a Fixed Column Using TextFX or Python Script
TextFX Characters is a plugin that inserts actual line breaks at a fixed column width. The default is 72 characters, but you can override it by copying your desired column number to the clipboard before running the wrap command.
TextFX hard-wrap steps:
- Install TextFX via Plugins > Plugins Admin (32-bit Notepad++ only)
- Select the text you want to wrap
- Copy your target column width number to the clipboard (e.g., type “80” and copy it)
- Go to TextFX > TextFX Edit > ReWrap Text to (Clipboard or 72) width
TextFX is only available for 32-bit Notepad++. If you’re running the 64-bit version, use a Python Script instead. A community-built Python Script replacement for TextFX ReWrap is available in the Notepad++ forums and accepts a prompt for your target column width (community.notepad-plus-plus.org, 2022).
How to Wrap Text in Notepad++ Using Find and Replace

Find and Replace with regex lets you insert actual line breaks into file content, turning a soft-wrapped display into hard-wrapped text. This changes the file. Make sure that’s what you want before running it.
The practical use case is converting a single long paragraph into a fixed-width block, like preparing text for a terminal or email body where line length matters at the file level.
Inserting Line Breaks with Regex
To hard-wrap at approximately 80 characters using Find and Replace:
- Open Find and Replace with Ctrl + H
- Check Regular expression mode at the bottom
- In the Search field, enter a pattern that matches your target column boundary
- In the Replace field, use n
(Unix) orrn(Windows CRLF) to insert a line break
- Use Replace All carefully, or step through with Replace one at a time
The regex approach takes some tuning depending on your content. A basic pattern like (.{80})s replaced with $1n breaks lines near the 80-character mark at a word boundary. Test on a copy of the file first.
CRLF vs LF Line Endings
On Windows, Notepad++ defaults to CRLF (rn) line endings. Using n alone in the Replace field inserts a Unix-style line ending, which can cause issues if the file is opened in other Windows tools like standard Windows Notepad.
Check the current line ending format in the status bar at the bottom of Notepad++ before replacing. It displays “Windows (CR LF)”, “Unix (LF)”, or “Macintosh (CR)”. Match your replacement to the existing format to stay consistent. You can also learn more about how to find special characters in Notepad++ to locate line break characters before you start replacing.
How to Wrap Text in Notepad++ Using Macros

Macros in Notepad++ record a sequence of actions and replay them on demand. For word wrap, that means recording the View menu toggle once and running it with a single keystroke from then on.
One thing worth knowing: Notepad++ macros work on lines, and having word wrap already enabled can interfere with line-based macro results (Cathrine Wilhelmsen, 2021). Turn wrap off before recording a macro that edits line content, then re-enable it after playback to verify the result.
How to Record a Word Wrap Macro
Recording steps:
- Go to Macro > Start Recording
- Navigate to View and click Word wrap
- Go to Macro > Stop Recording
- Select Save Current Recorded Macro
- Name it (e.g., “Toggle Word Wrap”) and assign a key combination
Assign the shortcut under the same Save dialog, or later through Settings > Shortcut Mapper. Tick the Ctrl and Shift checkboxes, then pick an additional key to complete the combination.
Running Macros for Batch Line Operations
Playback option: single run vs. run until end of file.
Single run (Macro > Playback) fires the macro once. The “Run a Macro Multiple Times” option lets you set an exact count or run until the end of the document. For inserting line breaks across a long document, that second option saves a lot of time.
Macros are stored in shortcuts.xml and survive restarts. They can also be edited manually in that file, though the XML format is not exactly friendly for complex edits. Python Script is a better option if your wrapping logic gets complicated.
Macro Limitations for Wrapping
Macros replay actions exactly as recorded. No conditional logic, no regex support, no dynamic column detection.
- Can’t adapt to variable line lengths
- Won’t skip already-wrapped lines
- Don’t support clipboard-based column values
For simple toggle automation, macros are perfect. For anything that requires checking content before acting on a line, switch to Python Script.
What Plugins Add Advanced Text Wrapping to Notepad++

Notepad++ supports plugins through the Plugins Admin panel, accessible via Plugins > Plugins Admin in the top menu. The plugin list is maintained as an open-source project on GitHub and includes both 32-bit and 64-bit entries (Notepad++ User Manual).
Notepad++ reached 27.4% usage among developers in the 2025 Stack Overflow Developer Survey, placing it third behind VS Code (75.9%) and Visual Studio (29%). That broad user base has driven a large plugin ecosystem covering everything from syntax extensions to scripting and text manipulation.
| Plugin | Wrap Capability | 64-bit Support | Install Via |
|---|---|---|---|
| TextFX Characters | Hard wrap at fixed column | No (32-bit only) | Plugins Admin |
| Python Script | Scriptable wrap logic | Yes | Plugins Admin |
| NppExec | Run external wrap scripts | Yes | Plugins Admin |
TextFX Characters Plugin
TextFX Characters adds a top-level TextFX menu with a “ReWrap Text to (Clipboard or 72) width” command. Select your text, copy the target column width to the clipboard, and run the command. The plugin inserts real line breaks into the file at that column.
Hard limit: TextFX is only available for 32-bit Notepad++. The official plugin is not listed in the 64-bit plugin registry (Notepad++ nppPluginList, GitHub). Some community forks exist for 64-bit, but they are unofficial and unsupported.
Python Script Plugin
Python Script gives Notepad++ full scripting access to the Scintilla editor component. For text wrapping, it replaces most of what TextFX used to do, and handles 64-bit installs cleanly.
A community-built rewrap script (available on the Notepad++ community forum, 2022) prompts for a column width between 8 and 2048, joins selected lines, and re-wraps at the target column. It respects CRLF, LF, and CR line endings by detecting the current document’s EOL mode.
Install Python Script:
- Go to Plugins > Plugins Admin
- Search for “Python Script”
- Check the box and click Install
- Restart Notepad++ when prompted
After installation, scripts are accessible under Plugins > Python Script > Scripts. You can also add scripts to the toolbar or assign keyboard shortcuts through the Shortcut Mapper. If you compare Notepad++ vs VS Code for this kind of extensibility, VS Code has a broader extension ecosystem, but Python Script gives Notepad++ enough scripting depth for most text processing tasks.
Why Word Wrap Does Not Work in Notepad++
Word wrap failing to activate, or randomly toggling off, is one of the most common issues reported in the Notepad++ community forum. Most cases have a clear cause.
A known bug in versions 8.4.6 through 8.4.8 caused the word wrap setting to not save after restart when using the installer version of Notepad++. The portable version was unaffected (GitHub, 2023). Updating to a current release resolves this.
Word Wrap Grayed Out or Disabled
Word wrap becomes unavailable in column editing mode. If you activated column mode (Alt + Click + Drag or Shift + Alt + Arrow), word wrap grays out in the View menu. Exit column mode first, then re-enable word wrap.
Also check Settings > Preferences > Performance. There is a checkbox labeled “Deactivate Word Wrap globally.” When enabled, Notepad++ disables word wrap automatically for files it classifies as large. This setting is enabled by default and is a common reason word wrap silently turns off on larger log or data files (Notepad++ Community, 2025).
Word Wrap Keeps Resetting Between Sessions
If word wrap turns off every time you restart Notepad++, the cause is almost always one of these 3 things:
- Multi-instance mode: multiple instances running simultaneously overwrite config.xml when they close, with the last-closed instance winning
- Write-protected config.xml: the file or its folder lacks write permissions, so the toggle state never saves
- Outdated build: Notepad++ versions 8.4.6-8.4.8 had a confirmed save bug affecting installer installs
Check Settings > Preferences > Multi-Instance and confirm you’re running in single-instance mode if the reset happens intermittently.
Horizontal Scroll Still Visible with Word Wrap On
Enabling word wrap does not always hide the horizontal scrollbar. This is a known UI behavior, not a sign that wrap is broken.
The scrollbar remains if any file in your session has a line that extends past the window width before wrapping recalculates. Switching tabs and back usually triggers a refresh. If the scrollbar persists, try toggling word wrap off and on once. How to remove empty lines in Notepad++ is another setting-related issue that sometimes comes up alongside display anomalies like this, and the fix pattern is similar: toggle the relevant setting to force a redraw.
Resetting Notepad++ Preferences as a Last Resort
If none of the targeted fixes work, a full preferences reset clears corrupted configuration state.
Steps to reset:
- Close Notepad++ completely
- Navigate to %AppData%Notepad++
- Rename or delete config.xml
- Relaunch Notepad++. A fresh config.xml is generated on startup
You will lose saved preferences like syntax theme, tab settings, and recent file history. Back up the folder before deleting if those settings matter. After the reset, re-enable word wrap via View > Word wrap and it should save correctly going forward. Also check how your editor compares to alternatives by reading about Notepad++ vs Notepad on word wrap behavior, since standard Windows Notepad handles the display setting differently. You can also look at how to use Notepad++ broadly for a refresher on settings management after a reset.
FAQ on How To Wrap Text In Notepad++
How do I enable word wrap in Notepad++?
Go to View in the top menu bar and click Word wrap. The setting applies instantly to all open tabs. No restart needed, and no file content is modified. The same path toggles it back off.
Does word wrap change the actual file content?
No. Soft wrap is display-only. Long lines appear as multiple visual rows in the editor but remain a single line in the file. Only hard wrap methods like TextFX ReWrap or regex replacement insert real line breaks into the file.
How do I make word wrap permanent in Notepad++?
Notepad++ saves the word wrap state automatically in config.xml on exit. If it keeps resetting, check for a write-protected config file, multi-instance mode conflicts, or update from a known buggy build (versions 8.4.6 to 8.4.8).
Is there a keyboard shortcut for word wrap in Notepad++?
There is no default hotkey. You can assign one through Settings > Shortcut Mapper by searching “Word wrap” in the Main menu tab. A macro recorded over the View toggle also works and can carry a custom key combination.
How do I wrap text at a specific column width?
Native word wrap follows window width, not a fixed column. For a fixed-column hard wrap, use TextFX Characters (32-bit only) or a Python Script plugin. The Edge Line feature adds a visual column guide without inserting line breaks.
Why is word wrap grayed out in Notepad++?
Column editing mode disables word wrap. Press Escape or click elsewhere to exit column mode, then re-enable word wrap via the View menu. Also check Settings > Preferences > Performance for the “Deactivate Word Wrap globally” checkbox, which silently disables it on large files.
Can I enable word wrap for specific file types only?
Not natively. The word wrap toggle is global across all open tabs. Per-file wrap requires the Python Script plugin, which can register a callback that checks each document’s file extension and applies the setting selectively on tab switch.
How do I insert actual line breaks at a fixed column using Find and Replace?
Open Find and Replace with Ctrl + H, enable Regular expression mode, and use a pattern like (.{80})s with a $1n replacement. This inserts real line breaks near the 80-character mark at word boundaries. Test on a copy first.
Does TextFX work with 64-bit Notepad++?
No. The official TextFX Characters plugin is 32-bit only and is not listed in the 64-bit plugin registry. On 64-bit Notepad++, use the Python Script plugin instead. A community rewrap script is available on the Notepad++ forum that replicates the TextFX column-wrap function.
Why does word wrap keep turning off on its own?
The most common cause is accidentally clicking the word wrap toolbar icon, located left of the paragraph mark icon. It toggles wrap on a single click. Remove it using the Customize Toolbar plugin, or check the Shortcut Mapper for an unintended key binding triggering the toggle.
Conclusion
This conclusion is for an article presenting every practical method to control line display and wrap long lines in Notepad++, from the basic View menu toggle to hard wrap at a fixed column width.
For most users, the one-click soft wrap toggle covers everything. No file content changes, no plugins needed.
When you need more control, the Python Script plugin handles per-file wrap logic, custom column widths, and persistent settings that survive restarts cleanly on both 32-bit and 64-bit builds.
If wrap keeps resetting, check config.xml permissions, the Performance preferences, and whether multi-instance mode is creating write conflicts on exit.
The editor display setting is simple. Getting it to behave exactly how you want just takes knowing which tool to reach for.
- How to Set Up Subscriptions on Google Play (Developer Guide) - July 12, 2026
- Why Work With a CMS Development Company for a Secure and Scalable Website? - July 12, 2026
- ADB Commands Cheat Sheet - July 11, 2026



