Sortwell sorts a folder of scans into one folder per batch. It is made for the Easy Index Scanning Workflow, created by Adam Pratt and Laura Woolsey (Learn the Easy Index Scanning Workflow): before each group of photos you scan (or capture on a copy stand) a colored card with the batch's date, number and subject. Sortwell finds every card, reads it, makes a folder named from it, and moves the card and the photos after it, up to the next card, into that folder.
One folder of scans After Sortwell
Scan-001 (divider card) 1982-10-31_Halloween_0001
Scan-002 ... Scan-004 Scan-001 (the card), Scan-002 ... Scan-004
Scan-005 (divider card) 1997-12-25_Christmas_0002
Scan-006 ... Scan-007 Scan-005, Scan-006, Scan-007
Sortwell comes two ways, with one license for both:
Nothing moves until you check each card and click Sort into folders, and every run can be undone.
Batch: 0001 Date: 1982-10-31 Subject: Halloween along the top (see Make divider cards Sortwell can read). Scan or capture them with the photos.Changed your mind? Library > Plug-in Extras > Undo a Sortwell run, or Undo in the app.
Next: Make divider cards Sortwell can read, Sort scans in Lightroom Classic, Sort a folder with the app, Read hard handwriting online, Finish the batch folders, Delete the cards when you're done.
Use solid, colored card stock in any color (pink, yellow, blue, green, orange …). White or grey cards look too much like the back of a print.
Put the card designator in the middle of each card: a circle with two opposite quarters filled in black (top left and bottom right), printed or drawn, about the size of a coin. This is how Sortwell tells a divider card from a photo, whatever color the card is. You can use a mark of your own instead (see Settings).
Along the top of the card, write each thing after a printed word saying what it is, with the date as year-month-day and 00 for a part you don't know:
Batch: 0001 Date: 1982-10-31 Subject: Halloween
Batch: 0003 Date: 1976-03-00 Subject: Spring Break (March 1976, day not known)
Batch: 0004 Date: 1975-00-00 Subject: baby (only the year is known)
Batch: 0005 Date: undated Subject: Grandma's house (no date at all)Use a dark pencil or marker, in clear letters. Sortwell reads printed numbers very well and clear handwriting well. Joined-up or faint handwriting is harder: the review lets you fix anything it misread, or you can have the hard ones read online with your own API key (see Read hard handwriting online).
The words before each part can be Batch, Number or No.; Date; and Subject, Description or Event. Without them Sortwell still finds the parts: a number on its own is the batch, a date is the date, and the rest is the subject.
The date can also be written 6/21/1987, 21 June 1987, June 1987, 1987, a range (1985-88), a decade (1970s) or a guess (circa 1962, c. 1962). When there is no date at all, write undated (in any capitals): it becomes the date part of the folder name, always as undated, and never part of the subject.
If you scan the back of each card too, that's fine: a blank card straight after a card is taken as its back and goes into the same folder.
Photos before the first card stay where they are.
Rather not make your own? The Easy Index Scanning Workflow course includes Sortwell Compatible Divider Cards in its Resources: https://chaos-to-memories.teachable.com/p/easy-index-scanning-workflow-memoryforward/
Use this for scans or tethered captures that are already in your catalog.
Sortwell moves the files (and their .xmp sidecars) on disk, adds them to the catalog at their new places, and puts back what the catalog knew about each photo: its pick or reject flag, stars, keywords, title, caption and the other IPTC fields, GPS location, its Develop settings (edits, crop and rotation) and the collections it is in. Then it removes the old entries, so the Folders panel shows the batch folders with their photos. (With Copy, rather than move, the originals stay in the catalog as they were, and the copies are added with the same catalog data.)
Let Lightroom import the moved photos in one go (on the review screen) is faster on big folders. Lightroom gives plug-ins no way to import many photos at once, so normally Sortwell adds them one at a time. With this ticked, Sortwell moves the files, removes the old entries, and then chooses Library > Synchronize Folder in Lightroom's own menu and clicks Synchronize, so Lightroom imports them all in one go. Then Sortwell puts back what the catalog knew about each photo, as above. In the Synchronize Folder dialog, Lightroom keeps the ticks you left last time: Import new photos should be ticked; Show import dialog before importing is best left unticked (if it's ticked, click Import in the dialog that opens); and leave Remove missing photos from catalog unticked (Sortwell has already removed the old entries, and that box would also remove any other missing photos in the folder). If Sortwell can't click Synchronize itself, it says so in the progress bar: click it, and Sortwell carries on. This works when the batch folders go inside a folder the catalog already has (such as the scan folder). On a Mac, the first time, allow Lightroom Classic under System Settings > Privacy & Security > Accessibility. Lightroom's menus must be in English. If the menu can't be used, Sortwell adds the photos one at a time as usual and says so.
Afterwards Sortwell opens the folder the batch folders went in. If that folder isn't in the catalog's Folders panel yet, the batch folders show at the top level instead: right-click one of them > Show Parent Folder to see them inside it. (Lightroom doesn't let plug-ins add a folder that has no photos in it.)
What can't be carried over, because Lightroom doesn't let plug-ins set it: virtual copies, stacks, Develop snapshots and the history list, links to publish services, and other plug-ins' fields. Sortwell tells you before anything moves if any of the photos have these. Tethered captures and fresh scans usually have none of them.
On Lightroom Classic older than 14.3, Sortwell can't remove the old entries itself, and they show as missing photos in the scan folder. Right-click the folder > Synchronize Folder and tick "Remove missing photos from catalog" to clear them.
Stopping part-way: if you click the small x on Sortwell's progress bar (top left in Lightroom), Sortwell asks first. Keep working carries on; Stop now stops after the photo it is on, and what is already done stays done (use Undo to put it back).
The cards get the keyword Picture Org > Divider card, so you can find them all in the Keyword List. (Cards marked by an older version, under Sortwell, are still found. Once nothing uses the old Sortwell keyword, you can delete it from the Keyword List.) Like all keywords our plug-ins add, it is never exported with your photos.
Use this for scans that aren't in Lightroom, or to sort a folder before you import it.
The app reads JPEG, TIFF, PNG, DNG and camera raw files (for DNG and raw files it uses the full-size picture stored inside the file).
If you choose Quit Sortwell in the Menu or close the browser tab while it is still working, Sortwell asks first: Keep working carries on, Quit anyway stops after the current photo and then quits. Closing the tab only closes the window; the work finishes on its own. Minimizing the window never stops anything.
To bring the sorted folders into Lightroom Classic afterwards, import the folder the batches went into as usual, with "Include Subfolders" on.
This is optional. For cards this computer can't read well, Sortwell can also ask an online service: Claude (Anthropic), OpenAI or Google Gemini, with your own API key, so what it costs goes on your own account (usually a fraction of a cent per card). Only the divider cards are sent, never your photos.
An API key is a long password that lets Sortwell use your account with the service. A chat subscription such as Claude Pro or ChatGPT Plus does not include one: the key comes from the service's developer site, which has its own sign-in and its own pay-as-you-go billing. You only need one key, from one service, and if you already saved one in Labelwell or Datewell, Sortwell uses it too. The sites change their menus from time to time, so a button may be worded a little differently from what is written here.
Which one to choose
Claude (Anthropic)
sk-ant-). The site shows the key only once; if you lose it, delete it there and create a new one.Google Gemini
AIza) and paste it into Sortwell.OpenAI
sk-) and paste it into Sortwell straight away; it is shown only once.Keeping your key safe
Treat the key like a password: don't email it, post it or put it in a screenshot. Sortwell keeps it on this computer only. If you think someone else has seen it, delete it on the service's site, create a new one, and paste the new one into Sortwell. The service's own billing page shows what you have spent, and you can set a spending limit there.
When a batch's photos are in order, Finish the batch folders makes each batch folder final:
undated;The date and the keyword are written into each photo (for camera raw files, into the .xmp sidecar beside it), so other programs see them too. Divider cards still in a folder keep their names and are left out of the numbering.
A preview shows every folder's new name, date and keyword, and the first and last new file names, before anything changes. Undo a Sortwell run puts the names, folders, dates and keywords back.
When you have finished with the batches (captions, rotation and so on), the cards can go.
| Setting | What it does |
|---|---|
| Finding the divider cards | Cards with the designator graphic (the usual way): a photo with the card designator on it is a card, whatever its color. The first photo is a card: for cards without a designator; Sortwell learns the cards' color from the first photo and finds the others of that color. Cards of any color: any photo that is mostly one solid color counts as a card. |
| Designator | Empty for the built-in one (the circle with two black quarters). To use a mark of your own, click Choose and pick a picture of it: dark on white (or on a transparent background), cropped close around the mark. Type or paste its path if you like. Built-in goes back to the circle. |
| Color match | For the two ways without a designator. Normal suits most cards. Loose for faded or unevenly lit cards; Strict if photos with a big patch of a similar color are taken for cards. |
| Photo order | File name (Scan-001, Scan-002 …, numbers in order, so 2 comes before 10) or Capture time (in the app: Date modified). |
| Dates like 6/7/87 | Month first (US: June 7) or Day first (6 July). A date like 21/6/87 is read correctly either way, since 21 can't be a month. |
| Batch numbers | As written (7), three digits (007) or four digits (0007, the default), so the folders sort in order. |
| Folder names | The pattern for the folder names. {date}, {batch} and {description} (the subject) are replaced by what the card says; a part the card doesn't have is left out with the text around it. The default is {date}_{description}_{batch}, for example "1982-10-31_Halloween_0001": underscores between the parts, so a later step (a script or another tool) can split the name into its date, subject and batch number. If you had kept the old default ({date}-{description}-{batch}), it moves to the new one. |
| Where the batch folders go | Inside the scan folder, next to it, or in a folder you choose (type or paste a path, or click Choose). |
| Copy, rather than move | On the review screen, under the folder the batch folders go in. Tick it to copy the photos into the batch folders and leave the originals where they are. |
Select the photo, then Library > Plug-in Extras > Mark as a divider card or Not a divider card, and run Sortwell again. Clear the divider card marking takes the mark off.
In the app, untick a photo that isn't a card on the review screen. For cards it misses, see Help.
Each run keeps a small undo file in your PictureOrg folder, "Sortwell-undo". A file that was moved or renamed after the run is left where it is, and the undo says so.
Every action in Sortwell has a key, and the same kind of action has the same key in every -well app: F chooses a folder, G starts the main step, X stops. Anything that writes, moves, renames or deletes files needs Shift (Shift+W saves), so a stray key press never changes your files. Keys do nothing while you are typing in a box, or while a card covers the button. Press ? in the app to see the keys for the screen you're on.
A key does exactly what clicking its button does, and only when that button is on the screen.
| Key | Does | Name for a Stream Deck button |
|---|---|---|
| F | Choose a folder | folder |
| G | Find the cards | go |
| X | Stop | stop |
| Shift+W | Sort into folders | write |
| Shift+U | Undo this run | undo-run |
| U | Undo an earlier run... | undo-list |
| N | Start over | new |
| O | Show the folders | open |
| Esc | Close the card | close |
| H or F1 | User Guide | guide |
| E | Create an error log | report |
| K | Check my setup | check |
| L | License... | license |
| Shift+Q | Quit | quit |
| D | Choose the divider card picture | card-picture |
| R | Choose where the folders go | root |
| I | Finish the batch folders... | finish |
| C | Remove or delete the divider cards... | cleanup |
| Shift+I | Finish the folders (in the Finish card) | finish-go |
| ? | Show the list of keys | keys |
Any macro pad that sends keystrokes (a Stream Deck Hotkey button, a Loupedeck, a programmable keyboard) can press the keys above while Sortwell's window is in front.
For buttons that work while Sortwell is behind other windows, add The Picture Org -well tools for Stream Deck, which comes with Sortwell: press ? in Sortwell and click Add Stream Deck buttons (the Stream Deck app, free from Elgato, must be installed). The Stream Deck app asks to install it. It adds two ready-made profiles, The Picture Org apps (a folder for each app with its window's actions) and The Picture Org in Lightroom (a folder for each app with its Lightroom commands), and two buttons under The Picture Org for building your own:
To put the ready-made buttons into a profile you already use (your own Lightroom profile, say), right-click an app's folder in the ready-made profile, choose Copy, then right-click an empty key in your profile and choose Paste: the folder comes with all its buttons, and its top-left key goes back.
Other tools can do the same from a command line: Sortwell --do <name> (on Windows, Sortwell.exe in Sortwell's folder), using the names in the tables. It only reaches the copy of Sortwell running for you on this computer.
Lightroom doesn't let a plug-in use keyboard keys or put a shortcut on its menu items, so ? works only in the Sortwell app's own window. In Lightroom, click Keyboard shortcuts (in the Sortwell window, next to User Guide, or in the Plug-in Manager) to see Sortwell's commands and the ways to run them without the menu, and to add the Stream Deck buttons. The Sortwell plug-in listens for Sortwell --do lr:<name> (and the Stream Deck button) instead, on this computer only:
| Library > Plug-in Extras | Name |
|---|---|
| Sort divider cards into folders... | lr:sort |
| Finish the batch folders (date, keyword, number the photos)... | lr:finish |
| Delete the divider cards | lr:delete-cards |
| Mark divider cards and rejects for deletion | lr:cleanup |
| Mark as a divider card | lr:mark-card |
| Not a divider card | lr:mark-not |
| Clear the divider card marking | lr:mark-clear |
| Undo a Sortwell run | lr:undo |
| Sortwell: Create an error log | lr:report |
Your own keys in Lightroom. In the Keyboard shortcuts window, choose a key for any of Sortwell's commands (for example Ctrl+Alt+Shift+C, or an F key on its own) and click Save keys. Keys are shared by all Picture Org plug-ins, so one key runs one command, and the window tells you if another plug-in already has the key you picked or if Lightroom uses it itself. The keys don't click through the menu: they hand the command straight to the plug-in, so they keep working when you add, remove or rename other plug-ins.
There are three downloads. The installers ask what to install: the Lightroom Classic plug-in, the standalone app (no Lightroom needed), or both. One license covers both, and you can run the installer again later to add the other.
Windows: the Setup program (ThePictureOrg-Sortwell-Setup-<version>.exe)
Mac: the Install Sortwell app (ThePictureOrg-Sortwell-Mac-<version>.zip)
A Mac with Apple silicon (M1 or later) and macOS 13 or later. Intel Macs aren't supported: on one, the installer says so and stops. The Windows version runs on any 64-bit Windows 10 or 11 PC.
Updating and removing: run the installer from the new download the same way, or click Install now when Sortwell offers an update (see Updates). Your settings and license key are kept. To remove Sortwell, use Uninstall Sortwell in the Start menu on Windows, or the Uninstall Sortwell app in the Mac download.
Installing the plug-in by hand: on Windows, right-click ThePictureOrg-Sortwell-Win-<version>.zip, choose Properties, tick Unblock, and unzip it. On a Mac, right-click Install Sortwell, choose Show Package Contents and open Contents > Resources. Move the PictureOrgSortwell.lrplugin folder somewhere permanent, then in Lightroom Classic choose File > Plug-in Manager > Add and pick it. Use one way or the other, not both, or the menu appears twice.
Where it goes: the installers put the plug-in in Lightroom's own plug-in folder for your user account, where Lightroom finds it by itself (%APPDATA%\Adobe\Lightroom\Modules\PictureOrgSortwell.lrplugin on Windows, ~/Library/Application Support/Adobe/Lightroom/Modules/PictureOrgSortwell.lrplugin on a Mac). No administrator password is needed. If the Mac installer has a problem, it keeps a log for support in ~/Library/Logs/PictureOrg/Sortwell-install.log.
%LOCALAPPDATA%\PictureOrg on Windows, ~/Library/Application Support/PictureOrg on a Mac.Updates within the major version are complimentary.
No cards were found: check that the cards have the designator on them (or, for cards without one, choose "The first photo is a card" or "Cards of any color", and try Color match "Loose"). With a designator of your own, check that its picture is cropped close and is the same mark as on the cards.
A photo was taken for a card: untick it in the review (or mark it "Not a divider card" in Lightroom). Without a designator, try Color match "Strict".
Check my setup (in the app's menu, or in File > Plug-in Manager with Sortwell selected) checks that everything Sortwell needs works on this computer, and shows the result as text you can copy or save.
Create an error log (in the app's menu, or Library > Plug-in Extras > Sortwell: Create an error log) saves a text file on your Desktop with what Sortwell did, then offers to send it to The Picture Org. You see exactly what would be sent before anything goes: your home folder, user name, computer name, email addresses and license key are already taken out, and you can delete anything else. Add a few words about what went wrong, and your email if you would like an answer, then click Send to The Picture Org. File and folder names are in it; your photos aren't. Nothing is sent unless you click Send. Without an internet connection, email the file instead.
Earlier versions: see CHANGELOG.txt.
© 2026 The Picture Org LLC · thepictureorg.com. Sortwell reads the cards with RapidOCR and finds them with OpenCV (and, only if you set it up, the online service you chose), and writes dates with ExifTool by Phil Harvey. See NOTICE.txt.
Divider cards and the Easy Index Scanning Workflow were created by Adam Pratt and Laura Woolsey: https://chaos-to-memories.teachable.com/p/easy-index-scanning-workflow-memoryforward/. Sortwell is an independent tool by The Picture Org.
This is the User Guide that comes with Sortwell, kept up to date with each release. Questions: info@thepictureorg.com · Sortwell home page · All the -well tools