Skip to content
This repository

Available pages:

Page translations: FAQ (castellano) FAQ (日本語) НПП SEG (Euskara)

I have been told to look for a file in my profile directory. So where are all my profile data stored?

Please select the menu entry Help -> Configuration Information and then scroll to the Paths section.

I have bookmarked a page, the star icon is shining, but I cannot see the bookmark in the Menu or in the bookmark panel.

When you add a bookmark from the star icon, it is automatically added to unsorted bookmarks folder.
You will find unsorted bookmarks only in the library (Ctrl+Shift+O)
You can move the bookmark to other folder with the star icon or in the library.       

I cannot save any bookmark and my history is empty. What should I do?

At first, please check that you have installed the Qt SQLite plugin. On Debian, this package is called libqt4-sql-sqlite. If you have it installed and you are still experiencing this issue, please run QupZilla from a terminal window and have a look at the output.
If it contains something like

QSqlQuery::value: not positioned on a valid record   
QSqlQuery::value: not positioned on a valid record

it seems that your profile database is broken. You can check it by some SQLite database viewer. If the database is empty, then you can recover it by creating new profile.
If it doesn't help, please open an issue.    

QupZilla is using a lot % of my CPU. What can I do to cool it down?

Well, the problem with using excessive amount of processor time is very likely caused by some flash content running in the browser (most likely bad coded advertisement). You have 3 options to solve this:

  • Completely disable flash support by unchecking Preferences -> Browsing -> Web Configuration -> Allow Netscape Plugins (Flash plugin)

Disable flash support

  • Use the Click2Flash plugin by checking Preferences -> Extensions -> folder "WebKit Plugins" -> Allow Click to Flash. You will now have to start every flash content on a specific site manually.

Enable click2flash

  • Use AdBlock to filter adverts Menu Tools -> AdBlock -> Enable AdBlock. If your filters list is empty, press Options to add filter subscriptions or to create own rules.

Enable AdBlock

I have heard that QupZilla supports importing bookmarks from other browsers, but I can't find this feature anywhere.

This feature has been added in version 1.0.0-rc1.

You will find the Import Bookmarks option in Menu File -> Bookmarks -> Organize Bookmarks:


The importing wizard will then guide you through the importing process. As you can see you will be able to export your bookmarks as well.

Site xyz offers less features in QupZilla than in other browser, is it possible to change the User Agent?

It might help, if you change the user agent in QupZilla. Starting with QupZilla version 1.1.8 you will be able to do this in the preferences:

Change user agent

It is even possible to define a User Agent per site:

Change user agent

I have started QupZilla, but it looks very very different from the screenshots (very ugly!).

You have probably downloaded a tarball for another Linux distribution and executed QupZilla from it.
You need to move files from /usr/share/qupzilla directory in the tarball to (probably) /usr/share/qupzilla directory in your system.
The exact path can be found directly from QupZilla: Menu Help -> Informations about application -> Paths -> Data
After a restart of QupZilla, it should work.
If you are not using a tarball for another Linux distribution, please verify, that you did not forget to run make install.

How can I get command line output in Windows?

You have to, obviously, run qupzilla.exe from command line. You will be able do it by following these steps:

  • Open Start -> Run -> type cmd.exe -> Enter
  • Then you have to cd into directory where qupzilla.exe is. For example: cd C:\\Program Files\QupZilla
  • To get output, you have to run qupzilla.exe 1> output.txt 2>&1 and output will be then written into output.txt file

How will I be able to debug QupZilla in case of a crash?

I assume you are using Linux and have gdb installed:
At first, you will have to build QupZilla with debugging symbols. For this, please add CONFIG += debug into the src/defines.pri file.
Then start a debugging session:

gdb ./path/to/your/compiled/qupzilla

You will get into gdb prompt. Type:


QupZilla should be running now. Make the steps to reproduce the crash and gdb will inform you about that. Now type:


and you have a backtrace of the crash that you can paste into your issue.

Starting with version 1.3.0 QupZilla is able to generate a backtrace and to save it into a file when QupZilla crashes. You will find this file in


However, this will only work, if QupZilla has been compiled with DEBUG support and with the GNU project debugger (gdb) installed. Please consult the documentation of your distribution.

Note: Please remove # characters from your backtrace when you are pasting it into issue. Otherwise, you would reference issues with number following after # character.
The best way to send backtraces would be to upload them at gist    

I have successfully compiled QupZilla on FreeBSD, but when I try to run it, only a blank window appears.

There is problem with raster graphics system on FreeBSD with (probably) NVIDIA drivers.
You can workaround it by running QupZilla with the native graphics system:

qupzilla -graphicssystem native

Please note, that running QupZilla with the native graphics system is very slow.

To fix this issue, you have to set 3 sysctls:


You can do it by

  • putting them in /etc/sysctl.conf and running /etc/rc.d/sysctl restart
  • set them manually with:
sysctl kern.ipc.shmmax=67108864
sysctl kern.ipc.shmall=32768
sysctl kern.ipc.shm_allow_removed=1

I am not able to load a specific https:// website. What can I do?

The QtNetwork stack (unlike other browsers network stacks), which is a part of the Qt Framework, does not support a fallback from the TLSv1 handshake to SSLv3. Thus, if a specific server does not understand the TLSv1 handshake, QupZilla is not able to load this specific website. To allow QupZilla to overcome this issue, it uses a list of known non-working servers and automatically sets SSLv3 as handshaking protocol for them.

Starting with version 1.6.3 non-working servers can be added by the user to QupZillas configuration file settings.ini, which is located in the profile directory.

If you find a specific https:// website, that might be affected by this issue, close QupZilla and open the configuration file with an editor of your choice. Go to the section [Web-Browser-Settings] and look for the parameter SSLv3Sites=. Per default the following servers are included:,,,,,,

Just add this specific website to this section, save the configuration file and you're done!

Something went wrong with that request. Please try again.