WordPress Development Stack Exchange is a question and answer site for WordPress developers and administrators. It's 100% free, no registration required.

Sign up
Here's how it works:
  1. Anybody can ask a question
  2. Anybody can answer
  3. The best answers are voted up and rise to the top

What is the difference, which one should I use?

I know that wp_verify_nonce checks the time limit, and check_admin_referer I think calls wp_verify_nonce as well as checking for an admin url segment, but I'm a bit confused on which one I should use and when.

Thanks for the clarity.

share|improve this question
Tumbleweed badge for this question? Really? Anyone? – Jeff Apr 19 '12 at 18:53
up vote 14 down vote accepted

I thought that check_admin_referer checked the nonce (it does call wp_verify_nonce, and the referring url. After digging into the core code I realised that it did not do this. Thinking it was a bug I reported it, and Ryan Boren replied with the following:

Actually, if the nonce is valid the referrer should not be checked. The unreliability of referrers is one of the reasons that nonces are used. Nonces replace referrer checking entirely. The only time we check the referrer is when handling the -1 backward compatibility condition. -1 means that someone is not using nonces so we fall back to referrer checking. This usage is now very rare. check_admin_referer() is badly named now that it almost never does referrer checking. It would be better named something like check_nonce(), but we keep it as is for back compat and old times sake.

So there is in fact there is no difference.

share|improve this answer
Nice digging work, thanks, that brings some clarity. – Jeff May 16 '12 at 22:19
There's actually one big difference that affects usage...check_admin_referer kills the entire script with die() if the nonce isn't valid, whereas wp_verify_nonce returns false. So if there are certain normal circumstances in which the nonce will fail, use wp_verify_nonce so that the rest of the script still executes. – SeventhSteel Mar 9 '15 at 18:41
@SeventhSteel - you are of course right. My interpretation of the question was that the logic of checking nonces were being compared rather than what happens when its invalid – Stephen Harris Mar 9 '15 at 18:58

Your Answer


By posting your answer, you agree to the privacy policy and terms of service.

Not the answer you're looking for? Browse other questions tagged or ask your own question.