Default Behaviours

What Happens Automatically

TheWebRatings handles these behaviors by default:

Auto-Prompt

After a user has visited your app across 3 separate sessions (30+ minutes apart), the widget automatically opens the review bottom sheet — stars visible, ready to tap. No code required.

• Backs off intelligently on dismissal (4 → 8 sessions → permanent stop)
• Stops permanently after a review is submitted
• Works alongside manual open() calls
• See Auto-Prompt for full details

Success Experience

When the review is submitted successfully, an inline success screen is shown inside the bottom sheet:

• Green checkmark animation with "Review published!" message
• Done button to close the widget

Offline Fallback

• Automatically stores feedback locally if submission fails
• Shows success to user even on network errors (better UX)
• Failed submissions are saved to localStorage for potential future handling

User Detection

Automatically detects user data from:

• Forms (email/name inputs)
• localStorage
• Cookies
• Global variables
• URL parameters

Existing Review Detection

Automatically checks if a user already submitted a review and shows the appropriate view (edit/delete vs new submission).

How to Disable Default Behaviors

Configure these in init():

<script>
  TheWebRatings.init({
    apiKey: 'your-api-key',
    autoPrompt: { enabled: false },  // Disable auto-prompt
    features: {
      offline: false,   // Disable offline storage
      retry: false,     // Disable automatic retry
      analytics: false  // Disable analytics
    }
  });
</script>

For more control, see Configuration Options.