How to Use webbrowser Module in Python: Open URLs Easily

Use the webbrowser module in Python to open URLs in the default web browser by calling webbrowser.open(url). This module provides a simple way to launch web pages from your Python script without extra setup.

Syntax

The webbrowser module provides functions to open URLs in a web browser. The most common function is webbrowser.open(url, new=0, autoraise=True).

• url: The web address you want to open as a string.
• new: Optional integer to specify how to open the URL: 0 opens in the same browser window, 1 opens in a new window, and 2 opens in a new tab.
• autoraise: Optional boolean to bring the browser window to the front.

python

import webbrowser

webbrowser.open('http://example.com', new=0, autoraise=True)

Example

This example shows how to open a website URL in the default web browser using the webbrowser module.

python

import webbrowser

url = 'https://www.python.org'
webbrowser.open(url, new=2)
print('Opened the Python website in your browser.')

Output

Opened the Python website in your browser.

Common Pitfalls

Some common mistakes when using webbrowser include:

• Not importing the module before using it.
• Passing an invalid or empty URL string.
• Expecting the function to block or wait; it opens the browser asynchronously.
• Assuming the browser will always open in a new tab or window without specifying the new parameter.

python

# Wrong: missing import
# webbrowser.open('http://example.com')  # This will cause an error

# Right way:
import webbrowser
webbrowser.open('http://example.com', new=1)

Quick Reference

Function	Description
webbrowser.open(url, new=0, autoraise=True)	Open URL in default browser; new=0 same window, 1 new window, 2 new tab
webbrowser.open_new(url)	Open URL in a new browser window
webbrowser.open_new_tab(url)	Open URL in a new browser tab

Key Takeaways

Import the webbrowser module to open URLs in the default browser easily.

Use webbrowser.open() with the URL string to launch web pages from Python.

The 'new' parameter controls whether to open in the same window, new window, or new tab.

Always provide a valid URL string to avoid errors.

webbrowser functions open browsers asynchronously and do not block your program.