Click to Change

Return to Top

Return to Top

Printer Icon


The Blue Letter Bible
Apps & Tools :: BLB ScriptTagger

BLB ScriptTagger

BLB ScriptTagger

ScriptTagger Example

Scripture References Right on Your Website

"BLB ScriptTagger" is a free tool that integrates into your website or blog to automatically create a hover display for all Bible references. The hover reveals the verse text and provides a link for further study at the Blue Letter Bible website.

What Does It Do?

The "BLB ScriptTagger" is a free tool that you can integrate into your website or blog to automatically create a hover display for all Bible references on the page. The hover reveals the verse text and provides a link for further study at the Blue Letter Bible website.

Try it out by hovering over the Scripture references in bold below:

This script will scan the text of your webpage for verse references such as this: Romans 1:16-18 or Jhn 3:16. It will then link them and automatically create and enable the hover.

You can set your preferred translation and various other settings. The script will also detect valid translation abbreviations connected with the reference, such as: Zephaniah 3:17 ESV

Other reference styles that this will automatically catch are: Deut 8:2-6, 10, 17-18 and Genesis 1:26-28; 3:15.

Installation Instructions

1. Website / Non-Wordpress Blog Installation

Copy the following lines of code into the <head> tag or footer of your webpage. If you use an include or template for your website, insert these lines of code into that template.

Note: The first line (bold portion) is the only required code to copy and paste into your webpage. The remaining lines represent the "additional settings" for BLB ScriptTagger operation.

// Required code

<script src="https://www.blueletterbible.org/assets-v3/scripts/blbToolTip/BLB_ScriptTagger-min.js" type="text/javascript"></script>

<script type="text/javascript">
// Additional settings

BLB.Tagger.Translation = 'NKJV';

BLB.Tagger.HyperLinks = 'all'; // 'all', 'none', 'hover'

BLB.Tagger.HideTanslationAbbrev = false;

BLB.Tagger.TargetNewWindow = true;

BLB.Tagger.Style = 'par'; // 'line' or 'par'

BLB.Tagger.NoSearchTagNames = ''; // HTML element list

BLB.Tagger.NoSearchClassNames = 'noTag doNotTag'; // CSS class list


For an explanation of the additional settings that you can define between the second set of <script> tags, see the table below:

Attribute Default Description
BLB.Tagger.Translation 'NKJV' What default translation should we display the verses in?
BLB.Tagger.HyperLinks 'all'

What should we do with references that are already links with an <a> tag?

  • 'all' - Point all linked references to the verse on Blue Letter Bible and create the hover effect.
  • 'hover' - Leave the reference links alone, but still create the hover effect.
  • 'none' - Leave the reference links alone altogether.
BLB.Tagger.HideTranslationAbbrev false If a Scripture reference is followed by a translation abbreviation (e.g., John 1:1 ESV), do you want to hide the abbreviation?

Note: BLB ScriptTagger will not automatically show translation abbreviations. This determines whether you want explicitly stated abbreviations hidden.

BLB.Tagger.TargetNewWindow true When a link in the hover is clicked, should it open in a new window?
BLB.Tagger.Style 'par' Do you want the verses to show up line-by-line, or in paragraphs?
  • 'line' - Line-by-Line
  • 'par' - Paragraph
BLB.Tagger.NoSearchTagNames '' A space or comma delineated list of HTML elements to skip over when searching for scripture references. This applies to your entire HTML document.

These elements are already ignored: 'applet, hr, head, img, input, meta, script, select, textarea'.

BLB.Tagger.NoSearchClassNames '' A space or comma delineated list of CSS classes which designate elements to skip over when searching for scripture references.

2. WordPress Plugin Installation

We have created a WordPress plugin for those who have created a website or blog through WordPress.org.

Note: Plugins are only applicable to privately-hosted blogs and web sites using the WordPress.org software. Plugins are not permitted on WordPress.com for various security reasons.

More information »

To implement this plugin, you will need to follow just a few, simple steps:

1.Download the BLB Wordpress Plugin

2. Login to manage your WordPress site or blog

3. From the Dashboard, navigate to 'Plugins' then select 'Add New'

Add New Plugin

4. Select 'Upload Plugin' at the top

Upload Plugin

5. Click 'Choose File'

Choose Plugin File

6. Looking at your list of plugins, find "BLB ScriptTagger" and click "Activate"

BLB ScriptTagger Activation

7. Hover over "Settings" and click "BLB ScriptTagger"

BLB ScriptTagger Settings

Adjust ScriptTagger by changing any of these settings:

BLB ScriptTagger Options

Additional Notes on Usage & Linking

  • Verse references that already have <a> tags or <cite> tags around them and do not contain the full verse reference will not get a hover tooltip. For example, in the following link, the "25" will not have a tooltip:

    <a href="./Bible.html">Romans 1:16-18</a>, <a href="./Verse.html">25</a>

    To resolve this issue, either:

    • Remove the anchor tags:

      <a href="./Bible.html">Romans 1:16-18, 25</a>

    • Add "Rom 1:" in front of the "25"

      <a href="./Bible.html">Romans 1:16-18</a>, <a href="./Verse.html">Rom 1:25</a>

  • The tooltip will only return up to seven (7) verses. If a verse range is longer than seven verses, then a "More »" link will be displayed, linking the reader to the whole chapter on the www.blueletterbible.org. For example, hover over the following reference: Psalm 119 NLT.
  • To display a verse reference in Spanish, specify "RVR60" as the value for BLB.Tagger.Translation. Or, add "RVR60" at the end of a verse reference, like this:
    Mark 10:45 RVR60.

The Blue Letter Bible ministry and the BLB Institute hold to the historical, conservative Christian faith, which includes a firm belief in the inerrancy of Scripture. Since the text and audio content provided by BLB represent a range of evangelical traditions, all of the ideas and principles conveyed in the resource materials are not necessarily affirmed, in total, by this ministry.