Kagi's Docs

Appearance

On this page

Lenses ​

Kagi Lenses allow you to customize your searches by specifying which websites (and other parameters) you see in your results. We provide a few Lenses to get you started, such as one to search only online discussions and forums.

Here's an example using the built-in Academic lens:

Lens Example

You can create your own Lenses where you specify parameters such as:

  • Region
  • Up to 10 included websites
  • Up to 10 excluded websites
  • Up to 5 included keywords
  • Up to 5 excluded keywords
  • File type
  • Results before a given date
  • Results after a given date

Lenses do not yet support image or video searches.

Default Lenses ​

Kagi offers several prebuilt lenses. The following are available by default:

  • Forums: search forums from around the Web.
  • Programming: official programming language websites and forums.
  • World News: recent information from a selection of global news outlets across the globe.
  • Academic: searches academic domains.
  • PDF: search for PDF files.
  • Kagi Help and Feedback: search Kagi's documentation and feedback websites.

The following lenses need to be activated from the Lenses settings.

  • Small Web: results that favor noncommercial domains and topics.
  • Recipes: common sense recipes from sites with no ads.

Lens Example ​

Let's say you love movie news and reviews. You can make a Lens that searches only the movie-related websites you find most useful.

  1. Go to the Lenses page and click the Create New button at the bottom of the page.
  2. Fill in the "Create Lens" page with the details of how you want the Lens to constrain searches. Perhaps you live in the United States and you like certain movie-focused websites.

Lens Form

  1. Click the Save button at the bottom of the page.
  2. Back on the Lenses page, switch your new Movies Lens to On.

Turn Lens On

  1. Do a search in Kagi for a movie title.

Search Results

  1. Once you see the search results, enable your Movies Lens.

Enable Lens

  1. You will see the search results constrained to specific websites based on the Lens.

Lens Results

Lenses are a powerful tool for making searches more useful. If you think about the types of things you search for often, you can probably create Lenses to make those searches more efficient and effective.

Sharing Lenses ​

You can share a copy of your lens with other Kagi users.

To enable lens sharing, first find the lens you want to share in your Active Lens list, and click the pencil icon to edit the lens.

Navigating to the lens you want to share

In the Edit Lens form, find the checkbox Share Lens Link. Enable it, then press save at the bottom of the page.

Toggle Share Lens Link in your lens settings

When you return to your lens list, you will see a new sharing icon that you can click to copy a sharing URL to your clipboard.

Appearance of lens with sharing enabled

You can send this link to anyone with a Kagi account. When they open the link, they will be brought to the Create Lens form with all the options from your lens pre-filled. They can make any edits they like before saving it to their account.

How Sharing URLs Work ​

When users open your sharing URL, it will pull the latest settings from your lens at that moment. This means you can make improvements or fixes to your lens without having to share a new URL.

After users have copied your lens, it will not receive updates from the original one.

Disabling the Share Lens option will invalidate the previously shared link. Re-enabling the Share Lens option will generate a new link.