# Luakit Documentation / Modules / history

# Module `history`

Save history in sqlite3 database

This module provides browsing history support. Pages are saved to an on-disk database automatically as the user browses.

The luakit://history/ page is provided by the `history_chrome` module.

## Functions

### history.init ()

Connect to and initialize the history database.

### history.add (uri, title, update_visits)

Add a URI to the user's history.

#### Parameters

- uri
  Type: string
  The URI to add to the user's history.
- title
  Type: string
  The title to associate with the URI.
- update_visits
  Type: boolean
  Optional
  Default: `true`
  `false` if the last visit time for this URI should not be updated.

## Properties

### history.db_path

Type: any type
Read-write
Path to history database.

### history.frozen

Type: {[string]=boolean}
Read-write
Set of webviews on which to freeze history collection.

## Attribution

#### Copyright

- 2010–2011 Mason Larobina