From ArchWiki
< GNOME(Redirected from GNOME Web)
Jump to navigation Jump to search

Web is the default web browser for GNOME. Web provides a simple and minimalist interface for accessing the internet. Whilst it is developed primarily for GNOME, Web works acceptably in other desktop environments as well.

Note: Web was known as Epiphany prior to version 3.4. The application was given new descriptive names, one for each supported language. The name Epiphany is still used in numerous places such as the executable name, some package names, some desktop entries, and some GSettings schemas.


Web can be installed by installing the epiphany package. If you want to save login passwords, install gnome-keyring.


Blocking advertisements

Enabled by default, one can disable it by unchecking Block Advertisements in Preferences. EasyList is the default blocking list. All lists are periodically refreshed.

To get list of currently enabled filters:

$ gsettings get org.gnome.Epiphany content-filters

To set new list of filters, for example uBlock Origin default lists:

$ gsettings set org.gnome.Epiphany content-filters "['', '', '', '', '']"
Tip: dconf-editor may be used as an GUI alternative.

See EasyList and Known Adblock Plus subscriptions for some of the popular ad blocking lists.

Tracking Prevention

Web includes Intelligent Tracker Prevention, which can be enabled in Preferences.

Firefox Sync

Web allows the usage of Firefox Sync to sync bookmarks, history, passwords and open tabs. It can be configured in the Import and Export dropdown menu.

Web applications

Web can create web applications out of websites and add them to desktop menu. To configure and remove them enter about:applications in the address bar.

Custom stylesheet

Web supports custom stylesheet you can enable under Fonts and style in Preferences.

Use example below to set new tab page layout and colors according to Adwaita dark variant:

#overview {
  background-color: #2E3436 !important;
  max-width: 100% !important;
  max-height: 100% !important;
  position: fixed !important;

#overview .overview-title {
  color: white !important;


Web does not check GNOME font settings, but checks Font configuration.


See GStreamer for required plugin installation.

To enable hardware accelerated video decoding, see GStreamer#Hardware video acceleration and #Hardware accelerated compositing.

Hardware accelerated compositing

By default hardware accelerated compositing is only used when required (on-demand) to display 3D transforms.

To force enable hardware accelerated compositing:

$ gsettings set org.gnome.Epiphany.web:/ hardware-acceleration-policy 'always'

Proxy configuration

Web provides for proxy configuration no graphical menu, instead use Proxy server#Environment variables

See also