WhoKnew Shield™ | Shortcode Attributes Reference (Full)

Skip to main content
Table of Contents
Print

TITLE: Shortcode Attributes Reference (Full)
CATEGORY: Basic Shortcodes
TAGS: Shortcodes, Reference, How-To, Pro,

The [whoknew-shield] shortcode accepts a small set of attributes that control what is protected and how. This article is the full reference: shortcode names, every attribute, allowed values, and where Pro’s click-to-reveal options are set (in settings, not in the shortcode) so you can look up syntax yourself.

Shortcode Names

Both of these work the same:

  • [whoknew-shield] — with a hyphen
  • [whoknew_shield] — with an underscore

Put the contact info between the opening and closing tags. There is no email="..." or link="true" attribute; for email, the plugin always outputs an obfuscated mailto link when protection is on.

Attributes

AttributeAllowed valuesDescription
typeemail, phone, address, or emptyWhat kind of contact is between the tags. If empty, the plugin detects from content (e.g. @ and a dot → email). Free supports email only for obfuscation; phone and address work in Pro. When in doubt, set type explicitly.
methodsComma-separated list of method names, or emptyObfuscation methods to use for this shortcode. Usually left empty so the plugin uses the methods from Protection Settings. Advanced use only; most users leave it blank.

There are no other shortcode attributes in the plugin. Attributes such as animation, speed, or reveal_text do not exist on the shortcode—they are not supported and will be ignored if you add them.

Pro: Click-to-Reveal (Not in the Shortcode)

In Pro, when Enable click-to-reveal is on in Protection Settings, shortcode output (and auto-detected mailto links) can be wrapped in a reveal button. The button text, animation (fade, slide, or none), animation speed (milliseconds), and button style (theme default, minimal underline, subtle gray, modern outline, elegant dark, and others) are all set in WhoKnew Shield → Protection Settings, not via shortcode attributes. So you cannot do [whoknew-shield animation="slide"]—that is a global setting. Use the same shortcode everywhere; change the look and behavior in the settings. See Click-to-Reveal Buttons (Pro) for the full list of button styles and options.

Examples

[whoknew-shield type="email"]you@example.com[/whoknew-shield]
[whoknew-shield]contact@site.com[/whoknew-shield]
[whoknew-shield type="phone"](555) 123-4567[/whoknew-shield]
[whoknew-shield type="address"]123 Main St, City[/whoknew-shield]

Tip: Only type and methods are valid shortcode attributes. To change reveal button text, animation, or speed in Pro, go to Protection Settings and use the Click-to-Reveal section there.

Need Help?

For copy-paste examples and where to use shortcodes: Basic Shortcodes. For Pro click-to-reveal options and button styles: Click-to-Reveal Buttons (Pro). For competitor shortcodes (e.g. encode, antispambot): Competitor Shortcode Compatibility.

Share