Drupal is a registered trademark of Dries Buytaert
drupal 11.3.7 Update released for Drupal core (11.3.7)! drupal 11.2.11 Update released for Drupal core (11.2.11)! drupal 10.6.7 Update released for Drupal core (10.6.7)! drupal 10.5.9 Update released for Drupal core (10.5.9)! cms 2.1.1 Update released for Drupal core (2.1.1)! drupal 11.3.6 Update released for Drupal core (11.3.6)! drupal 10.6.6 Update released for Drupal core (10.6.6)! cms 2.1.0 Update released for Drupal core (2.1.0)! bootstrap 8.x-3.40 Minor update available for theme bootstrap (8.x-3.40). menu_link_attributes 8.x-1.7 Minor update available for module menu_link_attributes (8.x-1.7). eca 3.1.1 Minor update available for module eca (3.1.1). layout_paragraphs 2.1.3 Minor update available for module layout_paragraphs (2.1.3). ai 1.3.3 Minor update available for module ai (1.3.3). ai 1.2.14 Minor update available for module ai (1.2.14). node_revision_delete 2.0.3 Minor update available for module node_revision_delete (2.0.3). moderated_content_bulk_publish 2.0.52 Minor update available for module moderated_content_bulk_publish (2.0.52). klaro 3.0.10 Minor update available for module klaro (3.0.10). klaro 3.0.9 Minor update available for module klaro (3.0.9). layout_paragraphs 2.1.2 Minor update available for module layout_paragraphs (2.1.2). geofield_map 11.1.8 Minor update available for module geofield_map (11.1.8).

Features

Basic Functionality

Domain Masquerade enables administrators and content managers to temporarily "switch" to viewing the site as if they were visiting from a different domain, all while staying on the current URL. The active domain context changes but the browser's address bar remains unchanged.

Unique Features

  • Session-based domain switching - The masquerade state persists across page loads within your browser session
  • Domain Switcher block - A ready-to-use block displays all active domains as clickable links
  • Admin route protection - Administration pages always use the real domain to prevent accidental configuration issues
  • Automatic validation - Invalid masquerade states (deleted or disabled domains) are automatically cleared
  • Decorator pattern integration - Seamlessly integrates with Domain module's negotiator service

Use Cases

  • Content Management: Preview domain-specific content, blocks, and menu items without leaving your current domain
  • QA Testing: Verify domain-based access controls and visibility rules in a single browser session
  • Development: Debug multi-domain issues without switching browser profiles or hosts files
  • Training: Demonstrate how the site appears to visitors on different domains

Post-Installation

  1. Configure permissions at /admin/people/permissions:
    • Grant the "Masquerade as any domain" permission to trusted roles (administrators, content managers). This permission is marked as restricted for
      security.
  2. Place the Domain Masquerade Switcher block:
    • Navigate to /admin/structure/block
    • Find the "Domain Masquerade Switcher" block and place it in a visible region (toolbar, sidebar, etc.)
    • The block only appears to users with the masquerade permission
  3. Using the switcher:
    • Click any domain name in the block to view the site as that domain
    • The currently active domain is shown in bold
    • Click "Clear masquerade" to return to the real domain based on your URL

No configuration page is required—the module works immediately after enabling and placing the block.

Additional Requirements

  • Drupal core: 10.3 or higher, or Drupal 11
  • Domain module: Required for multi-domain functionality

Activity

Total releases
1
First release
Dec 2025
Latest release
4 months ago
Release cadence
Stability
0% stable

Releases

Version Type Release date
1.0.x-dev Dev Dec 4, 2025