Effects · Gutenberg
Spotlight Reveal block for WordPress
A cursor-following spotlight that reveals content beneath a dark overlay. Move your mouse over the section to illuminate the hidden content.
Get Blockenberg
Free Gutenberg block in Blockenberg. The inspector controls and front-end behavior on this page come from this block’s source, not a shared stub.
What it actually does
A cursor-following spotlight that reveals content beneath a dark overlay. Move your mouse over the section to illuminate the hidden content.
Inspector panels on this block: Content, Background Image, Spotlight, Sizing. Those titles come from index.js, not from a shared template.
Behavior controls: “Trigger Mode” options: Cursor follow, Scan animation.
Where to find it
Gutenberg inserter → Effects → search “Spotlight Reveal” (block name `blockenberg/spotlight-reveal` in block.json). Style it in the sidebar after insert.
How to use Spotlight Reveal block for WordPress
- Install Blockenberg. Install from WordPress.org and activate the plugin.
- Insert the block. Edit a page, click +, search for “Spotlight Reveal”, insert it. Category: Effects.
- Configure inspector controls that exist on this block. Open Content. Set “Show Eyebrow”, “Show CTA Button”, “CTA Label”, “CTA URL”.
- Check the published page. The view script reads HTML data attributes: data-opts. The block editor preview may not run the same view script.
Inspector controls from this block’s code
| Control | What the code does |
|---|---|
| Show Eyebrow | On/off toggle in the inspector. On by default. Saved as `showEyebrow`. |
| Show CTA Button | On/off toggle in the inspector. On by default. Saved as `showCta`. |
| CTA Label | Text field in the inspector. block.json default: Explore Now. Saved as `ctaLabel`. |
| CTA URL | Text field in the inspector. block.json default: #. Saved as `ctaUrl`. |
| Trigger Mode | Select control; the chosen value is saved on the block. Options: Cursor follow; Scan animation. block.json default: cursor. Saved as `triggerMode`. |
| Spotlight Size (px) | Numeric range control in the inspector. Range 100–800. block.json default: 350. Saved as `spotlightSize`. |
| Softness (%) | Numeric range control in the inspector. Range 0–100. block.json default: 80. Saved as `spotlightSoft`. |
| Overlay Opacity (%) | Numeric range control in the inspector. Range 10–100. block.json default: 85. Saved as `overlayOpacity`. |
| Max Width (px) | Numeric range control in the inspector. Range 400–1400. block.json default: 800. Saved as `maxWidth`. |
| Padding Top (px) | Numeric range control in the inspector. Range 0–300. block.json default: 120. Saved as `paddingTop`. |
| Padding Bottom (px) | Numeric range control in the inspector. Range 0–300. block.json default: 120. Saved as `paddingBottom`. |
| Overlay Color | Color control in the inspector. block.json default: #000000. Saved as `overlayColor`. |
| Reveal/BG Color | Color control in the inspector. block.json default: #7c3aed. Saved as `revealColor`. |
| Heading | Color control in the inspector. block.json default: #ffffff. Saved as `headingColor`. |
| Subtext | Color control in the inspector. block.json default: #e5e7eb. Saved as `subtextColor`. |
| Eyebrow | Color control in the inspector. block.json default: #a78bfa. Saved as `eyebrowColor`. |
| Button BG | Color control in the inspector. block.json default: #7c3aed. Saved as `ctaBg`. |
| Button Text | Color control in the inspector. block.json default: #ffffff. Saved as `ctaColor`. |
What the front-end script actually does
- The view script reads HTML data attributes: data-opts.
When this is the right block
- A cursor-following spotlight that reveals content beneath a dark overlay. Move your mouse over the section to illuminate the hidden content — that is the job of Spotlight Reveal, not a generic content block.
- Use it when you need the editor control labeled “Show Eyebrow”, which exists on this block’s inspector.
- Inserter grouping: motion, overlays, and visual treatments.
Notes from the implementation
viewScript: this folder’s frontend.js is enqueued on the front end for this block.
FAQ
How do I add the Spotlight Reveal block in WordPress?
Install Blockenberg from WordPress.org, edit a page in the block editor, click +, and search for “Spotlight Reveal”. It sits under Effects. After insert, open Content and set “Show Eyebrow”, “Show CTA Button”, “CTA Label”, “CTA URL”.
What makes Spotlight Reveal different from other Blockenberg blocks?
A cursor-following spotlight that reveals content beneath a dark overlay. Move your mouse over the section to illuminate the hidden content. Inspector labels on this block include “Show Eyebrow”, “Show CTA Button”, “CTA Label”, “CTA URL”.
Is the Spotlight Reveal Gutenberg block free?
Yes. Spotlight Reveal ships inside Blockenberg. Get the plugin from WordPress.org — no paid add-on is required for this block.
Can I style Spotlight Reveal to match my theme?
Yes. Blockenberg’s shared typography and color panels apply here, plus any block-specific style controls listed on this page (panels: Content, Background Image, Spotlight, Sizing).
Related effects blocks
3D Text
Eye-catching 3D extruded text using CSS text-shadow layers and perspective transforms. Supports rotate-on-hover, float animation, and customizable depth, colors and typography.
Animated Text
Heading with animated cycling words — typewriter, fade, slide, or flip effects. Perfect for hero sections.
Card Carousel
Horizontal drag-to-scroll card carousel with rich cards, autoplay, arrows, dots, and responsive column settings.
Card Deck Slider
A 3D card deck slider where cards arc/fan out behind the front card and animate through the sequence.
Card Stack
A fanned or stacked pile of cards with hover-spread interaction. Perfect for testimonials, case studies, or feature highlights.
Confetti Button
A call-to-action button that triggers a burst of canvas confetti particles on click. Supports multiple confetti styles, custom colors, particle physics and link/action settings.
Get Blockenberg
Install Blockenberg from WordPress.org, then insert Spotlight Reveal from the Gutenberg inserter.