Getting Started
    Core Concepts
    Building Features
    API Reference
    Configuration
    Deployment
    Upgrading
    Migrating
    Pro
    Misc
    Shakacode logoShakaCodeDeveloped by

    Copyright 2026 ShakaCode

    Press Ctrl+K to search anytime
    Burger
    ShakaCode WebsiteCommunityReact on Rails ProGithubSmallView on Github
    Documentation
      Getting Started
      Core Concepts
      Building Features
      API Reference
      Configuration
      Deployment
      Upgrading
      Migrating
      Pro
      Misc
      Shakacode logoShakaCodeDeveloped by

      Copyright 2026 ShakaCode

      Deprecated Configuration Options

      This document lists configuration options that have been deprecated or removed from React on Rails.

      For current configuration options, see Configuration.

      Removed Options

      immediate_hydration

      Status: ⚠️ REMOVED in v17.0

      This configuration option has been removed. Immediate hydration is now automatically enabled for Pro users and disabled for non-Pro users.

      Migration: Remove any config.immediate_hydration lines from your configuration. Use per-component overrides if needed:

      # Pro users can disable for specific components:
      react_component("MyComponent", immediate_hydration: false)
      
      # Non-Pro users: immediate_hydration is ignored

      See CHANGELOG.md for details.

      Deprecated Options

      defer_generated_component_packs

      Type: Boolean Default: false Status: ⚠️ DEPRECATED

      Renamed to: generated_component_packs_loading_strategy = :defer

      Migration:

      # Old (deprecated):
      config.defer_generated_component_packs = true
      
      # New:
      config.generated_component_packs_loading_strategy = :defer

      See CHANGELOG.md for more details.

      Need Help?