Why does the OJS Crossref plugin show a 401 Unauthorized error?

A 401 Unauthorized error means the username and password entered in the OJS Crossref plugin settings do not match the credentials on your actual Crossref account. This is most often caused by a typo, an outdated password after a reset, or a browser autofill overwriting the Crossref fields with your OJS login instead. Re-enter your Crossref credentials manually, disable autofill on that form, and save again before retrying.

Why does OJS say my DOI has an invalid pattern?

An invalid DOI pattern error means the generated DOI suffix does not match the format Crossref expects, or the DOI prefix field in OJS's journal settings is missing, blank, or contains extra characters such as a trailing slash. Check that the prefix is entered exactly as assigned by Crossref, that the suffix pattern in OJS does not produce spaces or special characters, and that every article actually has a DOI assigned before you attempt to deposit it.

Common Crossref DOI Plugin Errors in OJS (and How to Fix Them)

Quick Answer

The most common Crossref DOI plugin errors in OJS are a 401 Unauthorized response (wrong or overwritten Crossref credentials), an invalid DOI pattern error (a missing or malformed prefix/suffix), and silent deposit failures where the XML submits but never actually registers. Most of these trace back to credential mix-ups or incomplete journal setup fields rather than a genuine plugin bug - the fixes below resolve the large majority of cases.

Error: 401 Unauthorized

Symptom: OJS returns a 401 unauthorized status when attempting to register or deposit a DOI.

This means the username and password entered in the plugin settings do not match the credentials on your actual Crossref account. Common causes:

A typo in the username or password field.
An outdated password after a Crossref credential reset that wasn't updated in OJS.
Browser autofill silently overwriting the Crossref fields with your OJS login (see below).

Fix: Re-enter your Crossref username and password manually, save, and retry the deposit. If you're unsure of your current Crossref credentials, confirm them with your Crossref sponsor rather than guessing.

Error: Browser Autofill Overwrites Crossref Credentials

Symptom: The plugin worked before, then suddenly fails with an authorization error after you revisited the settings page.

If your browser is set to auto-fill saved passwords, it can populate the Crossref username/password fields with your OJS admin login instead, the moment that settings page loads. If you don't notice and save the page, your real Crossref credentials get silently replaced.

Fix: Disable autofill for that specific form (or your browser generally while managing this page), and double-check both fields show your actual Crossref username and password - not your OJS login - before saving.

Error: Invalid DOI Pattern

Symptom: Crossref rejects the deposit with a validation error saying the DOI does not match the required pattern.

This usually means:

The DOI prefix field in OJS's journal setup is blank, incorrect, or has extra characters (like a trailing slash).
The suffix pattern configured in OJS produces spaces, unsupported symbols, or an empty string for some articles.
An article was submitted for registration before it actually had a DOI assigned to it.

Fix: Check that your prefix is entered exactly as assigned by Crossref (e.g. 10.xxxxx, no trailing slash), review your suffix pattern for edge cases, and confirm every article you're depositing already has a DOI generated. See DOI prefix vs. DOI suffix for how the two parts should look.

Error: Deposit Submits But Never Registers

Symptom: OJS shows the XML export/submission as successful, but the DOI never becomes resolvable on doi.org, and Crossref shows no record of it.

This is usually a schema validation failure that OJS doesn't surface clearly - the XML was sent, but Crossref's backend rejected it silently or queued it for manual review. Common triggers include missing required metadata fields (author names, publication date, or article title) or a mismatch between the journal ISSN in OJS and the ISSN on file with Crossref.

Fix: Check the article's metadata completeness in OJS before depositing, confirm the ISSN in OJS's journal settings matches Crossref's record exactly, and if the issue persists, ask your Crossref sponsor to check the deposit log on Crossref's side - they can usually see the actual rejection reason that OJS doesn't display.

Before You Configure: Required OJS Journal Setup Fields

Many plugin errors trace back to incomplete journal setup rather than the plugin itself. Before configuring the Crossref plugin, make sure these are filled in:

Journal Title
Journal Initials
Journal Abbreviation
Journal ISSN (print and/or online)
Principal Contact
Technical Support Contact

See the full setup walkthrough in How to Configure the Crossref DOI Plugin in OJS.

When to Contact Your DOI Sponsor Instead of Troubleshooting Alone

                If a deposit keeps failing after checking credentials, prefix/suffix formatting, and metadata completeness, the fastest fix is usually to ask your Crossref sponsor to check the deposit log directly on Crossref's side - they can see the exact rejection reason, which OJS often doesn't display in full. GetDOI/SRND customers get direct technical support for exactly this kind of issue as part of sponsored DOI registration.
            