Plex Movie Scanner/Agent confused by square brackets?

Server Version#: 1.42.2.10156
My movie collection is stored under a single “Movies” folder, with each movie in its own folder. Every folder is named using the same convention, with a sequential number (which I need for my own reasons) within square brackets, followed by the movie title, then the year between round brackets, like this:

[123] Batman Begins (2005)

Isn’t Plex supposed to ignore everything within square brackets? I have reinstalled Plex recently and re-indexed my movie collection, the current Plex Movie agent was able to match 10% of my movies, at most. I switched to the legacy agent and it got probably 50%. Could it be that the new agent gets confused by the square brackets?

Also, is there a way to bulk re-match the content of a library? I know you can do it individually, movie by movie, but it’s quite tedious…

Thanks in advance!

The agents ignore the contents of square brackets but that’s a format I’ve not seen.

For TEST CASE ONLY…

What if you take one and put the [123] at the end? Does it match that way?

@ChuckPa: thanks for the quick reply. I confirm that the issue is the square brackets in front of the movie name. More precisely, here are the folder names I tried and the results:

[1519] Splitsville (2025) => NOT matched automatically

Splitsville (2025) => Matched automatically

Splitsville (2025) [1519] => Matched automatically

I can’t really move the square brackets to the end of the folder name, because it’s used for sorting (too long to explain, it’s related to a small app I developed), but at least now we know exactly what the issue is. Do you know if there is a way to report this to Plex developers?

I think the issue is the first bracket.

‘way back when’ plex required an alphanumeric character to be the first character in a media file name. Not sure if that’s still the case.

It’s possible, I haven’t tried that. Note also that the actual MP4 file inside the folder is named exactly as the folder, save for the [nnnn] prefix. I guess the agent is using the folder name for matching the movie, not the file name…

@ChuckPa : do you think this can be submitted as a bug?

I submitted it to engineering .

They evaluated it this morning during triage and put it on the list of to-do.

I know you’re using [xxxx] Name (year) as your sorting
but that’s not a documented use.

They did write the scanner to expect the name first.

May I ask why you have [SeqNo] naming?

Two reasons: it allows me to sort the movies by date added (I’m talking about Windows Explorer, not in Plex) and it’s also used by a small app I wrote ages ago, which leverages the sequential number as a way to uniquely identify each movie.

I completely acknowledge this is a very rare - if not unique - case, on the other hand the agent is supposed to ignore anything within square brackets, regardless of the position in the folder or file name, so I think there’s an argument for it being a code defect :wink:

Well…

  1. Plex/web has Date added and other sorting already built in.

  2. Windows has the ability built in as well

  3. How to Change Column Settings in Windows Explorer - Microsoft Support

  4. I can do it natively on Linux too

  5. You made your own.

While we know the [ ] ignores. It’s NOT officially documented.
(Which I need to ask, and will ask, why )

https://support.plex.tv/articles/naming-and-organizing-your-movie-media-files/

They seems to accept this as something to work on but didn’t give any ETA.

Until you presented this, I’ve never seen this use case.

I wish I could help more but , at this point, we wait until they schedule and work on it.

I needed something more robust and stable than the OS “modified date”, plus my app needed an ID so I solved both problems by putting it in front of the folder name. Plex came later into the picture. Anyways, I completely accept this is a unique scenario, and I have no real expectations for the developers to fix it. It puzzles me because those brackets don’t confuse the scanner consistently, some movies get properly matched, others don’t. Moreover, the legacy movie scanner seemed to be much less affected by this.

Thank you for looking into it, much appreciated! And if they end up fixing it, super!

Note to myself: remember to rename movies like [REC] which contain square brackets in their name.

Screenshot 2025-10-02 at 08.20.55

I don’t think the renaming is needed since you’re already using a tmdb tag to tell Plex what to match it to.