Kagi Bangs

This is an open-source, community maintained repository of bangs used by Kagi Search.

You can submit changes to improve accuracy of existing bangs as well as create new bangs for use in Kagi Search.

Accepted changes are deployed to our website weekly.

Contribution Guidelines

Kagi Staff and maintainers of this repo have final say, but a good bang submission should follow some basic guidelines.

• The website must be reasonably well-known and widely used. For example, popular commercial services and forums are OK. Low-traffic independent sites, such as startups, local businesses, or personal blogs, are not OK.

• The trigger must be specific to the website, not a generic term or word. For example, "amazon.com" can have "!amazon" but not "!groceries".

• Each trigger must be unique. You can test your trigger on Kagi to see if a bang already exists with that trigger.

• You can use the Categories list below to find the Category and Subcategory that fits best. If you cannot find one, it can be omitted, or we can consider adding a new one.

• If the bang you wish to add does not fit the above criteria, you can still create a custom bang on your own Kagi account for your own use! See our documentation for details.

• Any modifications to bangs should be made to /data/bangs.json. /data/kagi_bangs.json provides bangs internal to Kagi itself (i.e., image search, search in a specific region)

Region Bangs

Currently, not all 2-char ISO country codes for regions Kagi supports are mapped to region bangs. Adding new region bangs will be handled on a case-by-case basis.

Bang Format

{
  "s": "Metacritic",
  "d": "www.metacritic.com",
  "t": "mc",
  "u": "https://www.metacritic.com/search/{{{s}}}/",
  "c": "Online Services",
  "sc": "Search"
}

Format Flags

The fmt field exists to tweak the behavior of how the bang is executed. For the majority of bangs, you do not need to specify this - we use defaults that work for 99.9% of bangs. But, it can be useful depending on the behavior of the website.

The field is an array of strings that act as a list of flags:

By default, all of these are enabled. If you specify fmt, you must exhaustively specify each options you would like enabled.

Categories

This is a list of possible categories, with their corresponding subcategories.

Entertainment

Man Page

Multimedia

News

Online Services

Region search

No corresponding subcategories.

Research

Shopping

Tech

Translation

Did you know?

As a Kagi user, you can make your own custom bangs right now in the Custom Bangs settings page or the Search Shortcuts menu.

These will be instantly available to you and will override any global bangs.

This repository is for adding new or fixing existing global bangs to Kagi.

Credits

Kagi bangs are made possible by DuckDuckGo which invented the concept in 2008.