App/UI/Address bar/Shortcuts

From XOWA: the free, open-source, offline wiki application

Shortcuts to wikis in the current language

XOWA has pre-defined shortcuts to different wikis. These allow quick access to an article in another wiki without entering in the full url.

For example, to open the English Wikipedia article on "Earth", you would ordinarily enter:

Instead, using shortcuts, you can enter:


Note that shortcuts are case-sensitive. "w:Earth" will work, but "W:Earth" will not.

The following table lists the shortcut for a given wiki type:

shortcut type example shortcut actual url
w Wikipedia w:Earth
d Wiktionary d:Earth
s Wikisource s:Earth
v Wikivoyage v:Earth
q Wikiquote q:Earth
b Wikibooks b:Earth
u Wikiversity u:Earth
n Wikinews n:Earth

Shortcuts to wikis in another language

Wikis in a non-English language can be opened by prefixing the language code to the shortcut.

For example, to go to, you would enter the following:


Note that fr is the language code for "French" and w is the XOWA type code for "Wikipedia" as defined above.

Search shortcut

In addition, there is a special shortcut designed for search.


This is equivalent to:


The following is a full list of default custom shortcuts

shortcut format 1
? Special:Search/~{0}?fulltext=yes

1Note that the ~{0} is used for substitution.

Customizing shortcuts

XOWA also allows customization of shortcuts by modifying the custom gfs file. See: Options: App - Startup

Shortcuts should be chosen wisely. In particular, using "http", "https" and "file" as a shortcut is heavily discouraged. Similarly, "Category", "Talk", "Help", "Template", "Wikipedia" and other wiki namespaces should be avoided.

NOTE: The following script may change in future versions. If your customized shortcut stops working in a future version, please check this page again.

app.gui_mgr.url_macros {
  // note that custom macros take precedence over types. For example, a custom macro of "en.w" will override the type macro of "en.w".
  custom {
    ~{0}: page
       The page is the rest of the url after the ":". For example, in "c:Earth", "Earth" is the page.
    set('c'    , '{0}');
    set('sp'   , '{0}');
    set('meta' , '{0}');
    set('wd'   , '{0}');
    set('wd.q' , '{0}');
    set('wd.p' , '{0}');
    set('?'    , 'Special:Search/~{0}?fulltext=y');
    // clear;     // clears all macros
    // del('c');  // deletes macro for "c"
  lang_default = 'en';  // sets default language to "en". Entering in "w:French" is the same as "en.w:French"
  types {
    ~{0}: language code
       The langage code is the part of the url before the first ".". For example, in "en.w:Earth", "en" is the language code.
       If a language code is not entered, then the "lang_default" will be used. For example, "w:Earth" has no language code, and "en" will be used.

    ~{1}: page
       The page is the rest of the url after the ":". For example, in "en.w:Earth", "Earth" is the page.
    set('w', '~{0}{1}');
    set('d', '~{0}{1}');
    set('s', '~{0}{1}');
    set('v', '~{0}{1}');
    set('q', '~{0}{1}');
    set('b', '~{0}{1}');
    set('u', '~{0}{1}');
    set('n', '~{0}{1}');
    set('a', '~{0}{1}');
    // clear;     // clears all macros
    // del('a');  // deletes macro for "a"



Getting started