Setting Kagi as Your Default Search Engine ​

Table of Contents ​

• Option 1: Use Orion browser by Kagi (currently for macOS/iOS only)
• Option 2: Using the Kagi Browser Extension
  • Setting up the Extension
  • Note for Safari Users: Browsing History
  • Note for Brave Browser Users
  • Note for Opera Browser Users
• Option 3: Manual Configuration
  • Custom use
  • Private Session link (use Kagi in private windows without logging in)
  • Chromium-Based Browsers (Chrome, Edge, Brave, Vivaldi, Arc...)
    • Desktop
    • Mobile
  • Firefox-Based Browsers
    • Desktop
    • Android Mobile
    • iOS
  • Safari
    • Desktop
    • iOS & iPadOS
  • Firefox Focus
    • Android Mobile
    • iOS
  • Custom Use

Option 1: Use Orion browser by Kagi (currently for macOS/iOS only) ​

If you use Apple devices with macOS/iOS/iPadOS you can use Orion browser by Kagi. It has Kagi built-in and is the easiest option to start using Kagi.

Download Orion.

Tip: It is recommended you enter your private session link in Orion settings, as it will allow you to use Kagi in private windows and after clearing cookies. To do this, first go to Orion > Settings.

Next, go to the Search tab, select Kagi under Search engine, then click on Kagi Settings.

A modal will appear, click the Get Your Session Link button to get the link with your token and paste it in the text field, then click OK.

Option 2: Using the Kagi Browser Extension ​

Kagi is available as an extension for all major browsers. The extension sets Kagi as the default search engine and allows you to search with Kagi even in a private window without logging in (this can be also set manually with the use of a private session link).

Extension download links:

• Chromium-based browsers (Chrome, Edge, Brave, Vivaldi, Arc...)
  • After installing the extension make sure to set Kagi as your default search engine.
• Firefox-based browsers
  • If you use Firefox on Android, check out this guide. There are many known limitations with the extension here, though.
  • After installing the extension, go to the extension settings (click the puzzle piece in the top right corner of the browser window) for Kagi and enter your private session token URL to be logged in automatically even when cookies have been deleted.
• Safari for macOS
• Safari for iOS and iPadOS
• The xSearch and HyperWeb extensions for Safari also support Kagi

If you are a macOS, iOS, or iPadOS user, you can complement your Kagi experience with the free Orion web browser, produced by the same team that built Kagi Search.

Setting up the Extension ​

To set up the Kagi extension for Safari on macOS click on the extension icon in Safari's toolbar and then:

• Make sure the Make Kagi Default Search Engine checkbox is checked to search Kagi from the address bar.
• Use the Get Your Session Link button to get the link with your personal token.
• Paste the Session Link in the text field. This will allow you to use Kagi Search in private windows.

Note for Safari Users: Browsing History ​

When you install the Kagi Search browser extension in Safari, you will see the extension requires access to your browsing history. This access is needed so the extension can intercept queries sent to other search engines and instead send them to Kagi Search.

No data from your browsing history is sent to Kagi Search beyond the search queries you make while running the extension. All queries made to Kagi Search are anonymized, never being tied to your specific Kagi Search account.

Note for Brave Users: Settings Update ​

In addition to installing the Kagi Browser Extension, Brave users must also make a settings change in the Brave web browser:

1. Go to Settings > Search engine (link).
2. Turn on the "Index other search engines" option.

Note for Opera Users: No Longer Compatible ​

Opera is no longer compatible as it is restricting users from using alternative search engines. If you are an Opera user you can reach out to Opera and request them to add Kagi to their list of search engines.

Option 3: Manual Configuration ​

You can configure your web browser manually to use Kagi as its default search engine.

If you are interested in using Kagi in private (incognito) browser windows, be sure to check our section on private session tokens​.

Custom Use ​

If you want to manually set Kagi as a default search engine, use these settings:

• Kagi Search URL https://kagi.com/search?q={searchTerms}

• Kagi auto suggestions URL https://kagi.com/api/autosuggest?q={searchTerms}

Private Session Link ​

To use Kagi Search inside a private browser window without logging in, you can use the Session Link feature found in your Account Settings.

The session link will include a special token that will allow you to log into Kagi even in a private browsing window.

Read more about Session Link

Chromium-Based Browsers (Chrome, Edge, Brave, Vivaldi, Arc...) ​

Unfortunately, as this github issue is tracking, there is a limitation with Chromium-based browsers, which don't allow extensions to set default search engines. As such, you need to do it manually.

Desktop ​

1. Right-click the Chrome address bar and choose Manage Search Engines and Site Search
2. In the Site Search section about halfway down, click the Add button at its upper right and fill in these details:
   • Search engine: Kagi Search
   • Keyword: kagi
   • Query URL: https://kagi.com/search?q=%s if you're not planning to use Kagi in private search. If you are, then use https://kagi.com/search?token=TOKEN&q=%s with the token found in your private session tokens​ replacing TOKEN.
3. Find Kagi again in the Site Search section. You may have to click Additional sites at the bottom if you don't see it right away.
4. Click the three dots next to the Kagi entry in the list.
5. Click Make default.

Note: Opera is no longer compatible as it is restricting users from using alternative search engines. If you are an Opera user you can reach out to Opera and request them to add Kagi to their list of search engines.

Mobile ​

1. Open https://kagi.com, log in, and submit a search.
2. Open your browser’s settings. Choose Search engine.
3. Select Kagi Search from the Recently Visited section.

If you want to have Kagi Search easily available on Android after configuring Chrome, follow these steps:

1. Go to the Home screen
2. Tap and hold anywhere to show options
3. Tap on Widgets
4. Find the Chrome widgets in the list
5. Select and add the Search widget

Firefox-Based Browsers ​

Desktop ​

1. Open https://kagi.com, then right-click the browser address/search bar and select Add Kagi Search.
2. Open this URL in your search bar: about:preferences#search
3. Scroll to Default Search Engine and select Kagi from the dropdown.

To set up a private session link in Firefox, use this extension with https://kagi.com/search?token=TOKEN&q=%s with the token found in your private session tokens​ replacing TOKEN.

Android Mobile ​

1. Tap the three-dot menu button.

2. Tap Settings.
3. In the General section, tap Search.
4. Tap Add search engine.
5. A list of additional predefined search engines will be displayed.
6. Tap the Other radio button to add a search engine and do the following:
   • in the Name field, enter Kagi.
   • In the Search string to use field, enter https://kagi.com/search?q=%s
   • In the Search suggestion API (optional) field, enter https://kagi.com/api/autosuggest?q=%s
   • Tap the confirmation button in the top right corner of the screen.

If your browser is configured to default to private browsing, this will require you to log back in to Kagi each time your tabs are closed. To get around this, in the Search string to use field, use your session link and append &q=%s at the end.

iOS ​

1. Tap the menu button, then Settings > Search > Add Search Engine.
2. Enter the following:
   • Title: Kagi
   • URL: https://kagi.com/search?q=%s
3. Tap Save.
4. Under Default Search Engine, select Kagi.

Safari ​

Desktop ​

1. Install the Kagi Search for Safari extension.
2. Activate the extension in Safari > Preferences > Extensions.
3. Enjoy Kagi search from your Safari address bar!

If you are a macOS, iOS, or iPadOS user, we strongly recommend using Kagi with the free Orion web browser, produced by the same team that built Kagi.

iOS & iPadOS ​

Use the Orion iOS/iPadOS web browser, which has native support for Kagi Search.

If you prefer to use Safari, you can use the Kagi Search for Safari extension.

Firefox Focus ​

Android Mobile ​

1. Tap the menu button, then Settings > Search > Search Engine > Add another search engine.
2. Enter the following:
   • Search engine name: Kagi
   • Search string to use: (use your session link and append &q=%s at the end)
3. Tap Save.

iOS ​

1. Tap the menu button, then Settings > Search Engine > Add Another Search Engine.
2. Enter the following:
   • Name to display: Kagi
   • Search string to use: (use your session link and append &q=%s at the end)
3. Tap Save.