Declared facts¶
You know your library better than any website does. Declared facts let an admin write down what the works in a folder, or in a whole library, are: their type (manga, manhwa, manhua, webtoon, comic, graphic novel or novel - each shown with the country it stands for, for example Manhwa (Korea)) and their creators (names, each with an optional role). MangaPixer shows them next to the series information and points out when a linked MangaUpdates record says something else.
Declared facts are explicit settings. MangaPixer never guesses them from the name of a library or folder: a folder called Manhwa declares nothing until an admin declares it.
Where they apply¶
A declaration applies to the folder (or library) and to everything below it, like the folder reading direction. The nearest declaration wins, separately for the type and for the creators:
- A library declared Manga makes every folder in it manga, until a folder below declares its own type.
- A folder that declares creators replaces the creators declared above it; the two lists are not combined.
- An archive shows what its folders declare.
Example: the library Comics declares Comic; its folder Imports/Korean declares Manhwa; the folder Imports/Korean/Some Series declares the creator A Writer (Story). Some Series is then a manhwa by A Writer, and every other folder in Comics is a comic without declared creators.
Set them (admins)¶
- A folder: Admin > Declared facts… in a folder's series panel or on its series page.
- A library: MangaPixer Administration > Libraries: the Declared: line under each library shows what the library declares; Edit opens the same editor.
In the editor:
- Type: pick one, or leave it at the first entry, which shows what applies from above (for example "Inherit: Manhwa (Korea), from Korean") or Not set. The types name their country of origin: Manga (Japan), Manhwa (Korea), Manhua (China), Webtoon (any country), Comic (Western), Graphic novel (Western) and Novel (any country). Pick by where the works come from; if you are not sure, leave it unset.
- Creators: type a name, pick a role if you know it (Story, Art, Story & art, or Any role) and press Add (or Enter). Each creator appears as a chip; remove one with its ×. Up to 20 creators. While a folder declares no creators, the editor shows the ones it inherits.
- Save. Clear removes this folder's or library's own declaration, so what is declared above applies again.
Only admins can see and change the editor. Every change is recorded in the audit trail.
What you see¶
The series panel and the series page show a Declared: line with the type and the creators; hover a value to see where it comes from ("set here", "from Korean", "from the Comics library"). Everyone who can open the folder sees the line. It is hidden while Show series information is off for the library or everywhere.
When the folder is linked to a MangaUpdates series that says otherwise, a Conflict badge appears under the line with what MangaUpdates says, so both sides are visible:
- Type: manga expects a Japanese record, manhwa a Korean one, manhua a Chinese or Taiwanese one; comic and graphic novel conflict with those three origins; novel conflicts with a comic record and every other type with a novel. A webtoon only conflicts with a novel. A record that does not say where it comes from never conflicts.
- Creators: a conflict when none of the declared names is one of the record's names. Names match regardless of word order, capital letters, accents and punctuation (
ODA EiichiroisEiichiro Oda), but a different spelling is a different name.
A declaration never changes the linked record, and the record never changes the declaration. If the conflict means the folder is linked to the wrong series, use Identify… to link the right one; if your declaration is wrong, edit it.
This folder's edition¶
New in 1.39.0. A folder can hold another edition of a series than the regular one - an omnibus, a master or a deluxe edition that puts several regular volumes into one book. Counted against the regular edition's volume list, such a folder looks incomplete: a 10-volume master edition of a series with 30 regular volumes would miss volumes 11 to 30, in MangaPixer and in apps that read the metadata export. The declared-facts editor of a folder has a section This folder's edition for that:
- Volumes in this edition: how many volumes the edition has (a whole number, 1 to 999). With a number set, the folder's volume answers count volumes 1 to that number, held as volume files: the volume total, the missing volumes, the Completion answer (the edition is the folder's Your edition, or the edition you picked, for example Omnibus edition) and the Missing report (total shown as "your edition"). The regular edition's volume list is no longer used for those volume answers, and no volume is offered as an upgrade. The chapter answers and the stacks of the Volumes view stay as they were; missing-volume cards from the regular list are no longer shown in that folder.
- Edition: an optional label - Regular, Omnibus, Master or Deluxe. It is shown with the count and in the export.
- Track completion: on by default. Turn it off for a folder you keep linked but do not collect to the end - a sampler, a reading copy, a partial reprint. The link, the series information, covers and refreshes stay; MangaPixer gives no Completion, missing or upgrade answer for it: the folder leaves the Missing report and the Completion tab (their summary lines count it as "not tracked"), its series line says Completion not tracked, and the metadata export marks it
tracking: "off"without a Completion block. Use Don't match only when the folder should have no series at all.
These three settings belong to the folder itself: unlike the type and the creators, they are not inherited by the folders below it, and a library has none. They are saved apart from the type and creators, so changing one never clears the other; Clear removes everything declared on the folder, these included. They are never used for matching. The Declared: line shows them briefly, for example "Omnibus - 12 volumes" or "Completion not tracked".
Declared facts and automatic matching¶
With Automatic matching on, declared facts are used as evidence. A declared type is a strong hint in both directions: records from the country the type names are clearly preferred, and records the type contradicts (a Japanese record for a folder declared manhwa) lose the same amount. That settles a tie between two series with the same name - a Korean webtoon and a Japanese manga both called Wind Breaker, for example - but it never beats a record whose title fits the folder better, and it never blocks a link: a folder declared with the wrong type still finds and links its series. The review list shows the evidence on each candidate (Fits declared type / Not declared type), and Identify… warns when the record you preview does not fit the declared type. Declared creators prefer records by them (a folder of several same-titled series links the one by the declared author) and never count against a record. See Automatic matching.
A folder declared Comic or Graphic novel is a comics work for automatic matching, whatever its files are called; a folder declared any other type is never treated as one, even when its files are numbered #12 or tagged by a Western publisher. See Comics signs.
Declared facts and Content¶
The folder Content setting (Doujinshi & adult one-shots, see Series information) stays a separate setting with its own menu; it is not a declared fact.
Privacy¶
Declared facts are stored in MangaPixer's own database. Reading or changing them makes no request to MangaUpdates or any other site, and no declared fact - type, creators, or the folders they are declared on - is ever sent anywhere; they are only compared, on your server, with what the sites return.
Artist folders¶
New in 1.37.0. Marking a folder an artist folder declares the artist as the folder's creator in the same step - the folder's name by default, with the role Story & art - and keeps the folder's other declared facts. The artist then works like any declared creator: it flows down to the works inside, and their automatic matching prefers records by that artist. Removing the artist-folder mark leaves the declaration; change or remove it here.
New in 1.47.0: a declared creator can carry a MangaUpdates author reference (set when you pick an author, or found on your server). A creator you add here (or rename) gets the reference of the one author your server already knows by that name - from the stored MangaUpdates authors or the tag index; two different authors by that name, or none, leave it empty - and nothing is sent to find it. Changing only the capitals, the word order or the accents of the name (BETA painter for Beta Painter) keeps the reference; a different name drops it, as before. In Match folders by name an author id that came from a local match is recorded in the audit log as local_author_match, apart from one you picked from the author search (author_search).
Good to know¶
- When a folder is renamed or moved, its declared facts go with it to the new folder, like its link and settings (see Renamed and moved folders); a new folder that already has declared facts of its own keeps them, and the old ones wait under Missing folders.
- Removing a library from MangaPixer removes its declared facts too.