Welcome to the Orion Docs!

Orion is a free, lightning-fast, privacy-protecting browser for Apple users, open to the web and all its standards and protocols. One day, we hope everyone will say Orion is the best browser for all Apple devices. We're glad you're here!

Please note that Orion Docs are in beta and thus are not yet complete. We haven't documented all of Orion's amazing features yet. But, we will be adding more documentation here over time.

If you're new to Orion, our Quick Start and FAQs are great places to begin.

You can access our documentation in several ways:

  • Click or tap an article link from the list.
  • Click or tap the magnifying glass icon at the top of the screen and do a search.
  • Use the !orion bang in Kagi Search. For example, searching in Kagi for !orion setting default search engine will show you results containing our documentation on how to set Orion's default search engine.

Feedback about this Orion documentation can be shared on our Discord Server in the #documentation channel. We would love to hear your thoughts on anything we can fix or improve.

Contributing

This documentation is open source at our Kagi Docs repo.

We gladly welcome any fixes & improvements! Please see our contribution guide before making a Pull Request.

Once your contributions are accepted, make sure to add yourself to the list of Contributors. Thank you!

About

Kagi Inc. is a company created with the mission to humanize the web. Our goal is to amplify the web of human knowledge, creativity, and self-expression and provide the user tools to fight against the web of greed, ad tech, and user tracking.

Kagi was founded in 2018 by Vladimir Prelovac in Palo Alto, CA (USA). Kagi has been completely self-funded since its inception.

Kagi Inc. currently has two products: Kagi Search, a fast, private search engine, and Orion Browser, a fast, zero-telemetry browser.

Our company headquarters are in Palo Alto, CA and our products are being built by a fully-remote team. Our team is small, like “feed with two pizzas” small. Of course, it’d be tricky to deliver those slices across 16 timezones, because our team is that remote.

Kagi Inc.
Palo Alto, CA, USA
Email: vlad@kagi.com

We hope that our work impacts people's lives in some small way for the better. Thank you for your interest in being a part of this!

"With Kagi and Orion, we’re striving to build better ways to experience the web, ways that are safe yet fun for everyone, including my own kids."

—Vladimir Prelovac

About

Kagi Inc. is a company created with the mission to humanize the web. Our goal is to amplify the web of human knowledge, creativity, and self-expression and provide the user tools to fight against the web of greed, ad tech, and user tracking.

Kagi was founded in 2018 by Vladimir Prelovac in Palo Alto, CA (USA). Kagi has been completely self-funded since its inception.

Kagi Inc. currently has two products: Kagi Search, a fast, private search engine, and Orion Browser, a fast, zero-telemetry browser.

Our company headquarters are in Palo Alto, CA and our products are being built by a fully-remote team. Our team is small, like “feed with two pizzas” small. Of course, it’d be tricky to deliver those slices across 16 timezones, because our team is that remote.

Kagi Inc.
Palo Alto, CA, USA
Email: vlad@kagi.com

We hope that our work impacts people's lives in some small way for the better. Thank you for your interest in being a part of this!

"With Kagi and Orion, we’re striving to build better ways to experience the web, ways that are safe yet fun for everyone, including my own kids."

—Vladimir Prelovac

Products

Kagi Inc. is currently a maker of two user-centric, privacy-respecting, common-sense obliging products.

Kagi Search is a fast, user-centric and private web search engine with great results.

Visit Kagi Search documentation.

Orion Browser

Orion Browser is a fast, user-centric, zero-telemetry web browser (currently macOS/iOS only).

Visit Orion Browser documentation.

History

Kagi was founded by Vladimir Prelovac in May 2018 in Palo Alto, CA (USA). Kagi is completely self-funded since its inception.

We are not affiliated with the legendary Kagi - the shareware payments platform. That Kagi went bankrupt in an unfortunate turn of events. We liked the name and acquired it when we got the chance.

Early years

In the first couple of years (2018 - 2019) Kagi was focused on AI technology, driven by the notion that any future search engine will need to have a strong instant question-answering component. We called it "the last mile of search" and this project gave us the domain knowledge and expertise used in Kagi Search today. Other experiments like video question answering were built during this period.

In 2019 the first prototype of Kagi Search is made public. It used an unusual MUD-like, command-line mode with powerful features built in.

First prototype of Orion browser with support for web extensions on iOS is made, giving us 'wings' to continue building the future best browser on Apple devices.

Timeline

2018 (The Age of AI)

  • Work begins on Kagi.ai
  • Team size: ~3

2019 (First products)

  • First prototype of Kagi Search
  • Donna.gg is launched using Kagi's early technology
  • Work begins on Orion Browser
  • Team size: ~5

2020-2021 (COVID years)

  • All blurred out. We worked a lot. The private beta of Kagi Search and Orion Browser launched
  • Team size: ~10

2022 (Public beta and paid customers)

What Does "Kagi" Mean?

The word "kagi" means "key" in Japanese.

Kagi is pronounced as kah-gee. You can listen to the pronunciation.

Who is Kagi's Mascot?

We simply call him ”Doggo” for now. He's adorable!

Doggo Kagi Mascot

Kagi Search Logo

Kagi Logo

More Kagi assets are available on the Kagi Assets page.

People sometimes ask why does Kagi have a "g" logo in the Google ballpark rather than a "k"?

Our designer insisted the Kagi logo is "anchored" in the letter "g," and we had to agree. Besides, we can't let Google own the letter "g" too, can we? ;)

Orion Logo

More Orion assets are available on the Orion Press Kit page.

Resources & Brand Assets

You can go to the Kagi Assets webpage to access our resources and brand assets.

They include:

  • The Orion web browser
  • Browser extensions for Kagi Search
  • Search and Autocomplete URLs for Kagi Search
  • Variants of our "g" logo
  • Typography
  • Brand Colors
  • Variants of Doggo the Kagi Mascot

Orion Browser

Orion browser has a press kit page with additional assets such as the logo and screenshots.

Work on Kagi Search

  • Do you have advanced Crystal language knowledge?
  • Can you solve difficult problems and code exceptionally well? (We’ll send a test project.)
  • Do you want to be a part of international and fully-remote team building products with care?

Help create the best search engine in the world.

  • Full-time or part-time (hourly rate) possible.
  • Flexible work conditions, remote work OK.
  • Early startup equity is available.

If so, send your CV to vlad@kagi.com.

Fun fact: All of Kagi Search works without JavaScript enabled in the browser. We see JavaScript as a way to enhance the product experience, not create it.

Work on Kagi Search

  • Do you have advanced Crystal language knowledge?
  • Can you solve difficult problems and code exceptionally well? (We’ll send a test project.)
  • Do you want to be a part of international and fully-remote team building products with care?

Help create the best search engine in the world.

  • Full-time or part-time (hourly rate) possible.
  • Flexible work conditions, remote work OK.
  • Early startup equity is available.

If so, send your CV to vlad@kagi.com.

Fun fact: All of Kagi Search works without JavaScript enabled in the browser. We see JavaScript as a way to enhance the product experience, not create it.

Work on Orion Browser

Requirements:

  • Swifth experience (3+ years) with macOS or iOS

Roles:

  • UI/UX developer: You have experience with macOS or iOS UX/UI components (AppKit/UIKit) and love creating native apps with great user interactions
  • Backend developer - You can write code in Swift but also delve into WebKit (C++) if needed
  • Extension support developer - You can help extend our WebExtensions API support by combining JavaScript, Swift (and occasionaly WebKit if needed)

We are hiring macOS and iOS developers for the Orion browser team. Create the best browser on Apple devices with us.

  • Full-time or part-time (hourly rate) possible.
  • Flexible work conditions, remote work OK.
  • Early startup equity is available.

Send your CV to vlad@kagi.com and we will send a test project.


We are particularly keen on hiring in Japan, the land of amazing WebKit browser heritage (Shiira, Sleipnir...)

様々なブラウザの歴史を持つ日本の皆さんこんにちは!

Kagi Inc. がお届けする Orion ブラウザは、世界最新の macOS/iOS 用ブラウザです。 https://browser.kagi.com/ 私たちの目指す「Apple デバイス用の最高のブラウザ」を一緒に作りましょう。

ポジション: macOS または iOS 開発者 (Orion browser を製作するチームです)

必須スキル: Swift, JavaScript and/or C++ AppKit or UIKit に精通しており、難しい問題を解決できる

採用フロー:

  1. CVの送付(英語にてご製作下さい)
  2. 弊社よりテスト用のプロジェクト (in AppKit or UIKit) を送付します
  3. ビデオ面接

雇用形態:

  • フルタイム、またはパートタイム(1時間単位での換算)
  • フルリモート
  • ストックオプションも選択可能です

なお、下記について予めご了承下さい:

  • 現在、日本に支社はございません。
  • 候補者様とのやりとり、面接、コミュニケーションなどにおいて使用される言語は英語のみとなります。

Donations

Kagi pledges to contribute 5% of our profits to the following organizations that align with our mission of humanizing the web:

Until we reach profitability, we are making a small monthly donation to the following projects:

Contact Us

  • For support user support@kagi.com
  • For all other inquiries use vlad@kagi.com

Support & Community

Get assistance, help shape the future of Orion and maybe even contribute!

Roadmap

Our community drives the future product direction of Kagi Search, and we hope you will become a part of it. Check out our roadmap.

Forum

You can join OrionFeedback.org to see the bug reports and feature requests we are discussing, reviewing, and planning to address and to the discussion.

  • Please see our Bug Reporting Guide for instructions on reporting issues.
  • All bugs and feature requests are encouraged to be posted on the forum.

Discord

In addition, you can also join our Discord! for real-time discussion about the product and chat with other Orion users.

Email support

Feel free to email us for support.

Support & Community

Get assistance, help shape the future of Orion and maybe even contribute!

Roadmap

Our community drives the future product direction of Kagi Search, and we hope you will become a part of it. Check out our roadmap.

Forum

You can join OrionFeedback.org to see the bug reports and feature requests we are discussing, reviewing, and planning to address and to the discussion.

  • Please see our Bug Reporting Guide for instructions on reporting issues.
  • All bugs and feature requests are encouraged to be posted on the forum.

Discord

In addition, you can also join our Discord! for real-time discussion about the product and chat with other Orion users.

Email support

Feel free to email us for support.

Troubleshooting Webpage Issues

Orion Compatibility Mode

If you're having an issue using a website on Orion for macOS, enabling Compatibility Mode for the website may resolve it.

Putting a website into Compatibility Mode will:

To put a website into Compatibility Mode, use the gear icon on Orion's toolbar:

Compatibility Mode for a Website on macOS

The gear icon also allows you to access other Website Settings that allow more granular control when troubleshooting.

iOS & iPadOS

iOS and iPadOS don't have the Compatibility Mode feature. But, you can disable content blockers for specific websites where they cause problems.

You just tap on the icon for a website in the address bar and then tap Turn off Content Blockers.

iOS

iOS Disable Content Blockers

iPadOS

iPadOS Disable Content Blockers

Troubleshooting Extension Issues

Orion supports both Chrome and Firefox extensions natively. Note that this support is still experimental and extensions may break or show unexpected behavior.

We recommend submitting such issues to orionfeedback.org.

Here are some extra things you can do to help us debug this:

  • Copy console errors from background-script [Window->Extensions->Console (from options popup button for specific web-extension)]

Enable extension console

  • Copy console errors from web-extension popup if applicable
  • Copy console errors from current active tab (in case its related to tab communication or content script)
  • Store URL for web-extension
  • Specify exactly what things are not working
  • Video and screenshot will be good contains comparison with chrome and firefox browser where its working perfectly

Supported OS Versions

We believe in the concept of "timeless computing," meaning that software should be built to last and new software should be mindful of older operating systems.

We try to maintain support for older operating systems whenever possible, while balancing the need to support newer OS versions.

macOS

We currently support these versions of macOS:

  • 10.14 (Mojave)
  • 10.15 (Catalina)
  • 11 (Big Sur)
  • 12 (Monterey)
  • 13 (Ventura)

We plan to add support for 10.13 (High Sierra) in the future.

Intel and Arm64 optimizations will automatically activate on your first run of Orion.

iOS and iPadOS

We currently support iOS and iPadOS 13.0 and later.

Product Roadmap & Feedback Forum

You can view our Orion Product Roadmap to see the bug reports and feature requests we are discussing, reviewing, and planning to address.

The Roadmap is part of our Orion feedback forum, where you are welcome to submit bug reports and feature requests of your own. Our community drives the future product direction of Orion and we hope you will become a part of it.

When reporting a bug, please give us as much detail as possible. This will help us understand the problem. Include information such as:

  • Steps to reproduce the problem
  • Screenshots of what you are seeing
  • Operating system and version
  • Orion version
  • Any browser extensions you are running and their versions
  • Any error messages from the console of your web browser

Reporting a Bug

When reporting a bug, it is important to give us as much information as possible to help narrow down what the issue may be. Browsers are very complex pieces of software—every detail matters!

Whenever you open a bug report, you will be given a template that you can fill out that will help you write your report. Here is a breakdown of what is included, and how it helps us!

Describe Your Issue

  1. Steps to reproduce. This is the most important piece of information for any bug report. lease include a clear list of instructions to reproduce the issue, even if you think it may be obvious. If we can not reproduce the problem, we are not able to fix it.

Important note: Most likely cause of problems on web pages is Content blocking and Web extension. You can rule out both quickly by enabling Compatibilty mode.

The second most likely cause of issues is WebKit, Orion's rendering engine. This is why we will ask you to check if the same problems exists in Safari browser. If it does it is most likely caused be WebKit and this can be more difficult for us to fix. In this case, you are encouraged to submit a bug report to WebKit.

  1. Expected behavior - What did you expect will happen? Indicating how other browsers behave may be useful. Use a screenshot/video to make your point if needed.

  2. A screenshot or video of the issue. Very often, this is the best way to help us understand your issue. A picture really is worth a thousand words when it comes to bug reports!

Give Us Some Context

  1. Orion, OS version; hardware type. What is the version of Orion, your system and what hardware you are running. You can copy this from Orion -> About menu if unsure. There is a lot of debug information available in Help -> Copy Debug Info to Clipboard that can be useful to us.

  2. Image/Video. It is always helpful to upload images/videos. Our site will aloow dragging and dropping files as you write.

Things to Try

Sometimes there are a few things you can do to help us narrow down certain issues. Depending on the problem, you can try:

Common Questions

My report includes NSFW media

Please don't post explicit images, videos, or text directly on the site.

If you can, please censor the images. Otherwise, you can leave them out. If we need them, we will ask you to provide them another way.

I just have a question or want to chat with other Orion users!

If you are just looking to chat or need some help, you are welcome to join our Discord server).

Discord Server

We have an Orion Discord server where you can provide general feedback and directly communicate with our community.

Please use the #introduce-yourself channel to say hello and let everyone know a bit about you.

We'd also love to hear your initial thoughts about Orion on the #first-impressions channel.

To make specific feature requests or bug reports, please use our Orion feedback forum rather than Discord.

Email Support

You can email support@kagi.com for customer support.

Before emailing, please see if your issue has been addressed on this knowledge base or our Orion feedback forum.

Keyboard Shortcuts

Orion for macOS uses OS-level keyboard shortcuts. You may wish to change certain shortcuts from their defaults. You may also find other apps have shortcuts that conflict with Orion's defaults. You can change the keyboard shortcuts for Orion or other apps based on your specific needs.

To change your shortcuts in macOS:

  1. Click the Apple menu () and click System Preferences.
  2. Click Keyboard.
  3. Click the Shortcuts tab.
  4. Click App Shortcuts in the list of options.

macOS Keyboard Shortcuts

Apple provides more detailed information about creating keyboard shortcuts and resolving shortcut conflicts.

Fastmail Issues

If you're having trouble using the Fastmail web app in Orion, the steps below may help.

  1. Leave the "Keep me logged in" box unchecked when logging into the Fastmail web app.

Fastmail Login

  1. While viewing the Fastmail web app at https://app.fastmail.com in Orion, enable Compatibility Mode by using the gear icon on Orion's toolbar:

Compatibility Mode for Fastmail on macOS

  1. Enable Compatibility Mode for www.fastmailusercontent.com in Preferences:
    1. Click the Orion menu and click Preferences.
    2. Click the Websites tab.
    3. Choose Compatibility Mode from the list of options.
    4. Click the + icon.
    5. Type or paste www.fastmailusercontent.com into the text field and click Add.
    6. You will see the addition reflected in your Preferences.

Compatibility Mode + Button

Compatibility Mode Add Website

Compatibility Mode Website Added

Contribute

The Orion user community is a diverse and passionate group of people who help make Orion better.

As our documentation is Open Source we are also supported by contributors of our community.

If you are going to support use, please join the Orion Discord server so we can collaborate.

Translations

Community members help Orion with translation support thereby making Orion globally accessible.

If you are interested in helping us sign up at https://localazy.com/p/orion-browser

Select the language(s) or let us know what language we should add.

Remember it is a marathon and not a sprint, steady translation progress helps us humanize the web.

As a token of appreciation for helping us make Orion more international we will be awarding Kagi Premium to select contributors.

We would like to say a big thank you to everyone who has contributed so far!

Quick Start

Table of Contents

Installing Orion

You can download an installer for Orion for macOS and install Orion for iOS/iPadOS from the App Store.

Orion is free and no account or signup is required to use it.

Website Settings

You're in control of your privacy and security with Orion. Click the gear icon at the top of an Orion for macOS window to access the Website Settings for the current webpage.

macOS Website Settings

Vertical Tabs

If you love to have your browser tabs on the side, Orion has you covered with native vertical tabs support.

macOS Vertical Tabs

Reader Mode

Bring peace to a cluttered webpage with Reader Mode.

macOS Reader Mode

Quick Searches

Get right to the content you're looking for by using Quick Searches that directly search your favorite websites.

Changing Bookmark Title

Web Archives

If a webpage won't load in Orion for macOS or you want to see an earlier version of it, you can see if the page is available in a Web Archive.

Here's an example of kagi.com's previous life when our domain was used by a payment processor:

Web Archive of kagi.com

Video Picture-in-Picture

When playing a video in Orion for macOS, you can view it in Picture-in-Picture mode.

macOS Picture-in-Picture

Focus Mode

Focus Mode allows you to completely remove toolbars from your browser interface. Browse the web distraction-free!

macOS Focus Mode

Edit Text on a Page

Sometimes you may want to quickly edit text on a page so you can take that perfect screenshot. Orion for macOS makes this possible.

macOS Edit Text

Show Console Errors

Web developers, we got you! You can add an indicator to the address bar of Orion for macOS that shows the number of errors on the page. This error indicator will allow you to quickly open Console and inspect the errors.

macOS Show Errors Example

Quick Start

Table of Contents

Installing Orion

You can download an installer for Orion for macOS and install Orion for iOS/iPadOS from the App Store.

Orion is free and no account or signup is required to use it.

Website Settings

You're in control of your privacy and security with Orion. Click the gear icon at the top of an Orion for macOS window to access the Website Settings for the current webpage.

macOS Website Settings

Vertical Tabs

If you love to have your browser tabs on the side, Orion has you covered with native vertical tabs support.

macOS Vertical Tabs

Reader Mode

Bring peace to a cluttered webpage with Reader Mode.

macOS Reader Mode

Quick Searches

Get right to the content you're looking for by using Quick Searches that directly search your favorite websites.

Changing Bookmark Title

Web Archives

If a webpage won't load in Orion for macOS or you want to see an earlier version of it, you can see if the page is available in a Web Archive.

Here's an example of kagi.com's previous life when our domain was used by a payment processor:

Web Archive of kagi.com

Video Picture-in-Picture

When playing a video in Orion for macOS, you can view it in Picture-in-Picture mode.

macOS Picture-in-Picture

Focus Mode

Focus Mode allows you to completely remove toolbars from your browser interface. Browse the web distraction-free!

macOS Focus Mode

Edit Text on a Page

Sometimes you may want to quickly edit text on a page so you can take that perfect screenshot. Orion for macOS makes this possible.

macOS Edit Text

Show Console Errors

Web developers, we got you! You can add an indicator to the address bar of Orion for macOS that shows the number of errors on the page. This error indicator will allow you to quickly open Console and inspect the errors.

macOS Show Errors Example

Frequently Asked Questions (FAQs)

What is Orion?

Orion is a free, lightning-fast, privacy-protecting browser for Apple users, open to the web and all its standards and protocols. It's based on the WebKit open-source browser engine that also powers Apple's Safari web browser. One day, we hope everyone will say Orion is the best browser for all Apple devices.

Orion was built for professionals by professionals, but anyone can benefit from it. Installing Orion with its default settings on any Apple device will cut down on annoying ads and speed up page loads. We want everyone to enjoy the web.

Why use Orion instead of Safari?

Safari is truly one of the best browsers you can use on macOS, and we’re grateful to Apple for creating such a solid foundation. By basing Orion on Safari’s tech stack, then adding productivity enhancements such as built-in ad-blocking, Orion can provide users with exactly what they need.

Why use Orion instead of Chrome, Firefox, or other browsers based on Chromium/Firefox?

Google and Mozilla have made great technological strides over the past decades. We’re grateful for those efforts because they help us take the next step in browser evolution.

How fast is Orion?

We are...ahem..fast.

How much memory does Orion use?

Orion is lightweight, with advanced memory-use technology that includes the best closed-tab management of all contemporary browsers

How does Orion respect my online privacy?

Orion has no built-in telemetry, so it can never "phone home" and risk exposing your data. Orion is truly and verifiably a privacy-respecting browser, unlike those that offer only an illusion of privacy.

How does Orion protect my online privacy?

Web ads have steadily eroded the online experience with their layout crowding, page slowing, annoying popups, and insidious malware. Yet, most browsers do not block ads by default. Orion is different.

How does Orion support extensions?

Orion supports browser extensions based on open-standard WebExtensions APIs. These are the same APIs that power browser extensions for Chrome and Firefox. So, we support many of those extensions on macOS, iOS, and iPadOS.

Does Orion have an iPhone or iPad app?

Yep, Orion is available for both iOS and iPadOS.

Is there anyway to get a previous build of Orion?

Yes, things don't always go as planed and mistakes can happen. If you ever need a perivous version you need to type a specific URL to get the version you want: https://browser.kagi.com/updates/{Current_OS}/{Orion_Beta_Version}.zip

Examples: Version 0.99.119-beta

  • https://browser.kagi.com/updates/13_0/119.zip (Ventura)
  • https://browser.kagi.com/updates/12_0/119.zip (Monterey)
  • https://browser.kagi.com/updates/11_0/119.zip (Big Sur)
  • https://browser.kagi.com/updates/10_15/119.zip (Catalina)
  • https://browser.kagi.com/updates/10_14/119.zip (Mojave)

How do I access my Favorites via shortcuts (CMD + #)?

Open Preferences -> Browsing, uncheck "Use cmd1 - cmd9 to switch tabs".

Note that Orion uses Bookmarks bar that is separate from Favorites for more control, so you would need to copy bookmarks you want to the Bookmarks bar folder.

Installing Orion

You can download an installer for Orion for macOS and read its latest release notes.

You can install Orion for iOS/iPadOS from the App Store and read its latest release notes.

Orion is free and no account or signup is required to use it.

Importing Data From Other Browsers

Orion for macOS can import data from several web browsers and source files:

  • Safari
  • Google Chrome
  • Brave
  • Bookmarks HTML File
  • Passwords CSV File

Orion for iOS and iPadOS cannot import data. But, it can sync data with Orion for macOS. So, you can do your data importing using Orion on a Mac and then sync your imported data to Orion on a iPhone or iPad.

Importing Data on macOS

  1. Click the File menu, click Import From, and click on a web browser or source file of your choosing.

Safari Import

  1. The data that you can import will depend on your choice of web browser or source file.
  • Web browsers may allow you to choose a browser Profile to import from and will allow you to choose the specific browser data that you wish to import.
  • Bookmarks HTML Files and Passwords CSV Files will need to you to choose a specific file in the appropriate format from your file system,
  1. Click the Import button for web browser imports or the Open button for file imports.

Safari Import

Safari Import

Google Chrome Import

Google Chrome Import

Brave Import

Brave Import

Default Search Engine

Table of Contents

No Preset Default Search Engine

Orion doesn't come with a default search engine preset. If it did, the moment you started typing in the address bar, it would leak your IP address and browser fingerprint to a search engine that you may prefer to avoid.

Our commitment to your privacy means that Orion will ask you to set your default search engine on your first use of the address bar. You can choose any search engine you wish. Or, you can choose "None" to not have a default search engine at all.

Setting or Changing the Default Search Engine

You can easily set or change Orion's default search engine at any time.

macOS

  1. Click the Orion menu and choose Preferences.

macOS Preferences

  1. Click the Search tab.
  2. You can choose your preferred "Search engine" from the list.

Choose macOS Search Engine

  1. Or, you can click the Manage button to manually configure a search engine.

Set macOS Search Engine Manually 1

  • Click the + button to add a new search engine.

Set macOS Search Engine Manually 2

  • Fill in the Name, Search URL Template, and Suggestion URL Template(optional) fields. If you don't know the template URLs, ask the provider of your search engine for them.
  • Click the Save Engine button.

Set macOS Search Engine Manually 3

iOS

  1. Tap the three-dot menu (•••) in the bottom-right corner of your screen.
  2. Tap Settings.

iOS Settings

  1. Tap Search Engine.

iOS Search Engine

  1. You can choose your preferred "Search engine" from the scrollable list.

iOS Choose Search Engine

  1. Or, you can tap the + button in the upper right corner to manually configure a search engine.

Set iOS Search Engine Manually 1

  • Fill in the Name, Search URL Template, and Suggestions URL Template (optional) fields. If you don't know the template URLs, ask the provider of your search engine for them.
  • Click the Save button.

Set iPhone Search Engine Manually 2

iPadOS

  1. Tap the three-dot menu (•••) in the upper-right corner of your screen.
  2. Tap Settings.

iPadOS Settings

  1. Tap Search Engine.

iPadOS Search Engine

  1. You can choose your preferred "Search engine" from the list.

iPadOS Choose Search Engine

  1. Or, you can tap the + button in the upper right corner to manually configure a search engine.

Set iPadOS Search Engine Manually 1

  • Fill in the Name, Search URL Template, and Suggestions URL Template (optional) fields. If you don't know the template URLs, ask the provider of your search engine for them.
  • Click the Save button.

Set iPadOS Search Engine Manually 2

Orion is in Public Beta

While Orion is in public beta, we don't feel our vision is fully realized and ready for prime time. But we also don't want to build something in isolation. We want to build it with you, our users. We appreciate your support and patience as Orion evolves.

During this time, we plan to fix bugs, introduce more core features, and improve the stability of the product. We hope to have v1.0 ready some time in 2023.

You can read more about this in our public beta announcement post.

What is Orion+?

Orion+ allows you to support the Orion project and mission. For a small fee ($5 per month or $50 per year), you’ll get:

  • Direct communication with the development team
  • The ability to influence the browser’s development
  • Access to nightly builds, bleeding-edge WebKit (faster than stable), and experimental features
  • The satisfaction of supporting an ad-free, unmonetized browser
  • An Orion+ icon to represent that support

We are still working on some of these features and they will be released shortly.

Your financial contribution will help us to stay independent and to deliver on our promise of becoming the best browser for Apple users. You can also help us by spreading the word about Orion everywhere you go, from social media to the dinner table.

Please note that Orion+ fees are not tax deductible.

Website Settings

Table of Contents

macOS Website Settings

You can click the gear icon at the top of an Orion window to access the Website Settings for the current webpage.

macOS Website Settings

You can control a number of settings related to the current website:

  • Enable or disable Compatibility Mode
  • Enable or disable Content Blockers
  • Block or unblock Web Fonts
  • Enable or disable Cookies
  • Enable or disable Reader Mode
  • Set Page Zoom between 50% and 300% to make content smaller or larger
  • Control Auto Play so that:
    • Media is always allowed to automatically play
    • Media with sound is automatically stopped
    • Media is never allowed to automatically play
  • Block or Allow Pop-up Windows
  • Set the User Agent to a web browser or custom User Agent String of your choice
  • Set whether the check of the SSL Certificate for the website must be Strict
  • Control whether the website is set to Allow access, Deny access, or Ask for access to your Camera, Microphone, Screen Sharing, Location, and Notifications

iOS Website Settings

You can tap the icon for a website in Orion's address bar to access the Website Settings for the current web page.

iOS Website Settings

You can control several settings related to the current website:

  • Set Page Zoom between 50% and 300% to make content smaller or larger
  • Enable or Disable Request Desktop Website, which shows a desktop computer version of the site rather than a mobile version
  • Use Turn Off Content Blockers to enable or disable Content Blockers
  • Enable or disable Use Reader Mode Automatically

iOS Website Settings Detail

iPadOS Website Settings

You can tap the icon for a website in Orion's address bar to access the Website Settings for the current web page.

iPadOS Website Settings

You can control several settings related to the current website:

  • Set Page Zoom between 50% and 300% to make content smaller or larger
  • Enable or Disable Request Desktop Website, which shows a desktop computer version of the site rather than a mobile version
  • Use Turn Off Content Blockers to enable or disable Content Blockers
  • Enable or disable Use Reader Mode Automatically

iPadOS Website Settings Detail

Website Settings

Table of Contents

macOS Website Settings

You can click the gear icon at the top of an Orion window to access the Website Settings for the current webpage.

macOS Website Settings

You can control a number of settings related to the current website:

  • Enable or disable Compatibility Mode
  • Enable or disable Content Blockers
  • Block or unblock Web Fonts
  • Enable or disable Cookies
  • Enable or disable Reader Mode
  • Set Page Zoom between 50% and 300% to make content smaller or larger
  • Control Auto Play so that:
    • Media is always allowed to automatically play
    • Media with sound is automatically stopped
    • Media is never allowed to automatically play
  • Block or Allow Pop-up Windows
  • Set the User Agent to a web browser or custom User Agent String of your choice
  • Set whether the check of the SSL Certificate for the website must be Strict
  • Control whether the website is set to Allow access, Deny access, or Ask for access to your Camera, Microphone, Screen Sharing, Location, and Notifications

iOS Website Settings

You can tap the icon for a website in Orion's address bar to access the Website Settings for the current web page.

iOS Website Settings

You can control several settings related to the current website:

  • Set Page Zoom between 50% and 300% to make content smaller or larger
  • Enable or Disable Request Desktop Website, which shows a desktop computer version of the site rather than a mobile version
  • Use Turn Off Content Blockers to enable or disable Content Blockers
  • Enable or disable Use Reader Mode Automatically

iOS Website Settings Detail

iPadOS Website Settings

You can tap the icon for a website in Orion's address bar to access the Website Settings for the current web page.

iPadOS Website Settings

You can control several settings related to the current website:

  • Set Page Zoom between 50% and 300% to make content smaller or larger
  • Enable or Disable Request Desktop Website, which shows a desktop computer version of the site rather than a mobile version
  • Use Turn Off Content Blockers to enable or disable Content Blockers
  • Enable or disable Use Reader Mode Automatically

iPadOS Website Settings Detail

Password Management

Table of Contents

Password Storage & Sync

Many users of Safari on Apple devices use iCloud Keychain to automatically sync Safari data, including website passwords, across devices.

Third-party web browsers, like Orion, cannot sync with the Keychain used by Safari. Orion must use its own Orion-specific Keychain. Safari cannot see the Orion Keychain and Orion cannot see the Safari Keychain.

If you want to use your Safari passwords in Orion, you will need to import the passwords into Orion on macOS. Then, you can use the passwords in Orion on all Apple devices through Orion's own Keychain sync.

Importing Safari Passwords into Orion on macOS

Orion on macOS can import your passwords from Safari 15+ on macOS. These versions of Safari ship with macOS 12 (Monterey) and macOS 13 (Ventura). They are also available on macOS 11 (Big Sur) through the Safari Technology Preview.

Once you have Safari 15+, follow these steps in Orion:

  1. Click the File menu, choose Import From, and choose Safari.

Importing from Safari

  1. Orion can import many different types of data from Safari, including passwords. Check and uncheck your desired import data and then click the Import button.

Safari Import

Syncing Passwords in Orion

To sync Orion passwords across devices, perform these steps on each device.

macOS

  1. Click the Apple menu (), click System Preferences, and click Apple ID.
    • If you're using macOS 3.14 (Mojave), you don't need to click Apple ID.

Open macOS System Preferences

Open macOS System Preferences

  1. In your iCloud/Apple ID settings, check the Keychain box if it isn't already checked.

Open macOS System Preferences

iOS

  1. Open the Settings app for your device.
  2. Tap your name at the top of Settings.
  3. Tap iCloud.
  4. Turn on Passwords and Keychain if it isn't already on.

iOS iCloud Settings

iOS iCloud Keychain Settings

iPadOS

  1. Open the Settings app for your device.
  2. Tap your name at the top left corner of Settings.
  3. Tap iCloud.

ipadOS iCloud Settings

  1. Turn on Keychain if it isn't already on.

iPadOS iCloud Settings fro Keychain

iPadOS iCloud Keychain Settings

1Password & Orion

1Password has not yet added support for Orion. Because of this, the 1Password browser extension does not function properly in Orion.

We have been told by 1Password that their development team is working on a new feature to allow users to choose their trusted browser. This will hopefully allow 1Password's browser extension to then work with Orion. 1Password has not given us any time estimate for when this new feature will be released.

In the meantime, 1Password 8 for macOS has a global autofill feature that does not require using any browser extension. Click inside a login field and press the command and \ keys at the same time.

Syncing Orion Data

macOS Syncing Example

Table of Contents

To sync Orion tabs, bookmarks, and reading lists across devices, perform these steps on each device.

macOS

  1. In Orion, use the Orion menu to open Preferences.

Open Orion Preferences

  1. Click the Sync tab and check the box for Enable cross-device sync of your tabs, bookmarks, and reading list.

Orion Sync Tab

iOS

  1. Open the Orion app.
  2. Tap the three-dot menu (•••) in the lower-right corner of the screen.
  3. Tap Settings.

iOS iCloud Settings

  1. In the Sync section, turn on Sync if it isn't already on.

iOS iCloud Settings

iPadOS

  1. Open the Orion app.
  2. Tap the three-dot menu (•••) in the upper-right corner of the screen.
  3. Tap Settings.

ipadOS Settings

  1. In the Sync section, turn on Sync if it isn't already on.

iPadOS Orion Sync Settings

Troubleshooting

If you have problems syncing between devices try the following:

On iOS open Settings/Apple ID/iCloud/Apps Using iCloud/Show All and toggle off and on the button beside Orion

or

On MacOS open Settings/Apple ID/iCloud/iCloud Drive/Apps Syncing to iCloud Drive - Options and uncheck and check the box beside Orion

Reader Mode

Sometimes you just want to read the article on a website, not wade through ads, video embeds, and other distractions. Reader Mode is here to help. (Note that Orion's ad-blocking is deliberately disabled in the macOS example below.)

macOS Reader Mode

Table of Contents

macOS Reader Mode

You can enable Reader Mode in three different ways while viewing a webpage.

  • Click the icon on the left side of the address bar that looks like a document.

macOS Reader Icon

  • Use the View menu and choose Show Reader.

macOS Show Reader Menu

  • Type ⇧⌘R (Shift and Command and R) on your keyboard.

You can use the reverse of the three methods above to disable Reader Mode.

While in Reader Mode, you can use the icon on the right side of the address bar that looks like two letter A's to configure the layout the mode uses. You can control:

  • Text size
  • Background color
  • Font
  • Content width
  • Text justification
  • Borders

macOS Reader Options

You can view and manage the Reader Mode settings for all websites in Orion's Preferences.

macOS Preferences Menu

macOS Reader Mode Preferences

iOS Reader Mode

You can enable Reader Mode by tapping on the icon for the current website in the address bar and then tapping Reader Mode.

iOS Reader Mode

While in Reader Mode, you can use the icon on the left side of the address bar that looks like a document to configure the layout the mode uses. You can control:

  • Text size
  • Font
  • Background color
  • Text justification

From this menu you can also tap Reader Mode again to disable the mode.

iOS Reader Options

You can view and manage the Reader Mode settings for all websites in Orion's Settings.

iOS Settings

Tap Reader Mode.

iOS Reader Mode Settings

iOS Reader Mode Settings Detail

iPadOS Reader Mode

You can enable Reader Mode by tapping on the icon for the current website in the address bar and then tapping Reader Mode.

iPadOS Reader Mode

While in Reader Mode, you can use the icon on the left side of the address bar that looks like a document to configure the layout the mode uses. You can control:

  • Text size
  • Font
  • Background color
  • Text justification

From this menu you can also tap Reader Mode again to disable the mode.

iPadOS Reader Options

You can view and manage the Reader Mode settings for all websites in Orion's Settings.

iPadOS Settings

Tap Reader Mode.

iPadOS Reader Mode Settings

iPadOS Reader Mode Settings Detail

Vertical Tabs

If you love to have your browser tabs on the side, Orion has you covered with native vertical tabs support. Here's what it looks like on macOS.

macOS Vertical Tabs

Table of Contents

macOS Vertical Tabs

You can enable vertical tabs by clicking the View menu and choosing Show Vertical Tabs Sidebar.

macOS Vertical Tabs Menu

You can disable vertical tabs by going under the same View menu and choosing Hide Vertical Tabs Sidebar.

iOS Tab Styles

You can switch between Sidebar or Grid tab styles in Orion's settings.

  1. Tap the three-dot menu (•••) in the bottom-right corner of your screen.
  2. Tap Settings.

iOS Settings

  1. Tap Tab View Style.

iOS Tabs Settings

Then, choose between Sidebar or Grid.

iOS Tabs Settings Detail

iPadOS Tab Styles

You can switch between Sidebar or Grid tab styles in Orion's settings.

  1. Tap the three-dot menu (•••) in the upper-right corner of your screen.
  2. Tap Settings.

ipadOS Settings

  1. Tap Tab View Style.

iPadOS Tabs Settings

Then, choose between Sidebar or Grid.

iPadOS Tabs Settings Detail

Tab Groups

In Orion, Tab Groups are also called Named Windows. You can sync the tabs in a Named Window across Orion on all devices. Here's what it looks like in macOS.

macOS Tabs Groups

Table of Contents

macOS Tab Groups

Simply use the Rename command in the windows menu to give the current window a name, such as "Work".

macOS Windows Menu Rename

macOS Rename Title

The Tab Group will now sync in Orion across all of your devices where syncing is enabled.

iOS Tab Groups

  1. Tap the icon that looks like two squares at the bottom on the screen.

iOS Tabs Icon

  1. Tap the Tabs menu at the bottom of your screen. The location and appearance of the menu can vary based on whether you use Sidecar or Grab tabs and how many tabs you have open.

iOS Tabs Menu 1

iOS Tabs Menu 2

  1. In the menu at the bottom on the screen, tap New Tab Group from X Tab (the X will vary based on how many tabs you have open.)

iOS Tab Group Options

  1. Enter a name for the new tab group and tap Save.

iOS Tab Group Name

The Tab Group will now sync in Orion across all of your devices where syncing is enabled.

iPadOS Tab Groups

  1. Tap the icon that looks like two squares at the top right of the screen.

iPadOS Tabs Icon

  1. Tap the Tabs menu at the bottom of your screen. The location and appearance of the menu can vary based on whether you use Sidecar or Grab tabs and how many tabs you have open. In the menu that appears, tap New Tab Group from X Tab (the X will vary based on how many tabs you have open.)

iPadOS Tabs Menu 1

iPadOS Tabs Menu 2

  1. Enter a name for the new tab group and tap Save.

iPadOS Tab Group Name 1

iPadOS Tab Group Name 2

The Tab Group will now sync in Orion across all of your devices where syncing is enabled.

Profiles

With Orion Profiles, you can create multiple identities to be used online and keep all your Orion information separate, like bookmarks, history, passwords, extensions, and other settings.

To create new and manage existing profiles, Use the File -> Profiles menu. Every Orion installation comes with the Default profile.

Orion has complete isolation of Profile information at the app level. That means that Profiles will have their own separate:

  • Settings
  • Passwords
  • Extensions
  • Bookmarks
  • History
  • Sessions and website data

Moreover, Profiles in Orion appear as separate apps in your Dock. The app-level separation between profiles has multiple advantages, such as if one of your Profiles crashes, the others are left intact.

Also, you can keep different profiles in your Dock and launch them with one click.

Using Quick Searches

Table of Contents

macOS Quick Searches

You can search specific websites directly in Orion with Quick Search bookmarks that use invocation keywords.

For example, let's create a YouTube Quick Search bookmark:

  1. Visit the following URL and start adding a new bookmark for it, but don't save the bookmark yet: https://www.youtube.com/results?search_query=cats

Adding a Bookmark

Adding a Bookmark

  1. In the window that appears, make several changes:
  • Under the "Add this page to:"" menu, choose whether you want the new bookmark saved to Favorites or some other location.
  • Change the Title of the bookmark from "cats - YouTube" to a broader search title of your choice, such as "YouTube Search".
  • Click the More Options button.

Changing Bookmark Title

  1. In the updated window, make two more changes:
  • In the URL of the bookmark, replace the "cats" search query text with %s so the URL is now: https://www.youtube.com/results?search_query=%s
  • Add yt as the "Invocation character or keyword".
  • Click the Add button

Editing Bookmark

Now, typing yt cats in Orion's address bar will send you into a search for "cats" on YouTube. And, typing yt dogs in Orion's address bar will send you into a search for "dogs" on YouTube. You can use the yt invocation keyword to search YouTube for anything.

Changing Bookmark Title

You can repeat this process with the search results page for any website to add another Quick Search bookmark.

You can also edit any existing search results bookmark to make it into a Quick Search bookmark.

iOS Quick Searches

Quick Searches will be coming to iOS soon and these instructions explain how they will work.

You can search specific websites directly in Orion with Quick Search bookmarks that use invocation keywords.

For example, let's create a YouTube Quick Search bookmark:

  1. Visit the following URL and start adding a new bookmark for it, but don't save the bookmark yet: https://m.youtube.com/results?search_query=cats

Adding a Bookmark

Adding a Bookmark

Adding a Bookmark

  1. In the window that appears, make several changes:
  • Change the Title of the bookmark from "cats - YouTube" to a broader search title of your choice, such as "YouTube Search".
  • In the URL of the bookmark, replace the "cats" search query text with %s so the URL is now: https://www.youtube.com/results?search_query=%s
  • Add yt as the "Invocation character or keyword".
  • Under Location, choose whether you want the new bookmark saved to Favorites or some other location.
  • Click the Save button

Editing Bookmark

Now, typing yt cats in Orion's address bar will send you into a search for "cats" on YouTube. And, typing yt dogs in Orion's address bar will send you into a search for "dogs" on YouTube. You can use the yt invocation keyword to search YouTube for anything.

You can repeat this process with the search results page for any website to add another Quick Search bookmark.

You can also edit any existing search results bookmark to make it into a Quick Search bookmark.

iPadOS Quick Searches

Quick Searches will be coming to iPadOS soon and these instructions explain how they will work.

You can search specific websites directly in Orion with Quick Search bookmarks that use invocation keywords.

For example, let's create a YouTube Quick Search bookmark:

  1. Visit the following URL and start adding a new bookmark for it, but don't save the bookmark yet: https://m.youtube.com/results?search_query=cats

Adding a Bookmark

Adding a Bookmark

Adding a Bookmark

  1. In the window that appears, make several changes:
  • Change the Title of the bookmark from "cats - YouTube" to a broader search title of your choice, such as "YouTube Search".
  • In the URL of the bookmark, replace the "cats" search query text with %s so the URL is now: https://www.youtube.com/results?search_query=%s
  • Add yt as the "Invocation character or keyword".
  • Under Location, choose whether you want the new bookmark saved to Favorites or some other location.
  • Click the Save button

Editing Bookmark

Now, typing yt cats in Orion's address bar will send you into a search for "cats" on YouTube. And, typing yt dogs in Orion's address bar will send you into a search for "dogs" on YouTube. You can use the yt invocation keyword to search YouTube for anything.

You can repeat this process with the search results page for any website to add another Quick Search bookmark.

You can also edit any existing search results bookmark to make it into a Quick Search bookmark.

Viewing Web Archives

If a webpage won't load in Orion for macOS or you want to see an earlier version of it, you can see if the page is stored in the Wayback Machine Internet Archive.

While viewing the page in Orion for macOS (or trying to view it), click the Tools menu and choose Open Page in Internet Archive.

Here's an example of kagi.com's previous life when our domain was used by a payment processor:

Web Archive of kagi.com

Picture-in-Picture Videos

When playing a video in Orion for macOS, you can view it in Picture-in-Picture mode.

Click on the View menu and choose Show Picture-in-Picture Video or type Control-Command-P on your keyboard.

By default, the PiP video snaps to a corner of your screen. But, you can hold down the Command key and drag the video to any position you wish.

macOS Picture-in-Picture

Focus Mode

Focus Mode allows you to completely remove toolbars from your browser interface. Browse the web distraction-free! Here's an example on macOS.

macOS Focus Mode

Table of Contents

macOS Focus Mode

You can enter Focus Mode by clicking the View menu and choosing Enable Focus Mode. Or, you can type Shift-Command-F on your keyboard.

macOS Focus Mode Menu Choice

To exit Focus Mode, click the View menu and choose Disable Focus Mode. Or, you can type Shift-Command-F again on your keyboard.

iOS Focus Mode

  1. Tap the three-dot menu (•••) in the bottom-right corner of your screen.
  2. Tap Settings.

iOS Settings

  1. Turn on Focus Mode.

iOS Focus Mode Settings

Here's an example of YouTube in Focus Mode.

iOS Focus Mode Example

iPadOS Focus Mode

  1. Tap the three-dot menu (•••) in the upper-right corner of your screen.
  2. Tap Settings.

ipadOS Settings

  1. Turn on Focus Mode.

ipadOS Focus Mode Settings

Here's an example of CNN in Focus Mode.

ipadOS Focus Mode Example

Low Power Mode

Inspired by the same feature on iPhone, Low Power Mode reduces Orion's power consumption up to 90%. It does this by cleverly suspending browser tabs you haven't used after five minutes.

Table of Contents

macOS Low Power Mode

You can enable Low Power Mode by clicking the Tools menu and then clicking Low Power Mode....

macOS Low Power Mode Menu

You can then click the Enable button in the window that appears.

macOS Low Power Mode Settings

You can disable Low Power Mode using the same menu option.

iOS Low Power Mode

You can enable Low Power Mode in Orion's Settings.

  1. Tap the three-dot menu (•••) in the bottom-right corner of your screen.
  2. Tap Settings.

iOS Settings

  1. Turn on Low Power Mode.

macOS Low Power Mode Settings

You can disable Low Power Mode from the same place.

iPadOS Low Power Mode

You can enable Low Power Mode in Orion's Settings.

  1. Tap the three-dot menu (•••) in the upper-right corner of your screen.
  2. Tap Settings.

iOS Settings

  1. Turn on Low Power Mode.

macOS Low Power Mode Settings

You can disable Low Power Mode from the same place.

Allow Copy Paste

Some webpages prevent copy or paste. It's annoying! You can easily override this in Orion for macOS.

  1. While on the annoying webpage, click the Tools menu.
  2. Click Allow Copy & Paste.

macOS Allow Copy & Paste

Edit Text on Page

Sometimes you may want to quickly edit text on a page so you can take that perfect screenshot. Orion for macOS makes this possible.

  1. While on the webpage, click the Tools menu.
  2. Click Edit Text on Page.
  3. Make Your text edits.
  4. Use the Tools menu again and choose Edit Text on Page to stop editing.

macOS Edit Text

Float on Top

Floating a window on top is a feature of many paid apps on the Mac App Store. Orion for macOS has it built-in for free.

  1. While viewing a window in Orion that you want to float, click the Window menu.
  2. Click Float on Top or type Control-Command-U.

The window will now float on top of all others. You can use the same menu choices or keyboard command on the window to disabling floating.

Show Console Errors

This one's for the web developers out there. You can add an indicator to the address bar of Orion for macOS that shows the number of errors on the page. This error indicator will allow you to quickly open Console and inspect the errors.

  1. Click the Develop menu.
  2. Click Show Console Errors Indicator.

macOS Error Indicator Menu

macOS Show Errors Example

Block Auto-Play

Many websites have videos and other media that automatically play when you load webpages.

On Orion for macOS, all media with sound is automatically stopped by default. There is a setting to quickly change auto-play behavior across all websites. Unique auto-play settings can also be made for specific websites.

To configure auto-play settings:

  1. Click the Orion menu.
  2. Click Preferences.

Orion Preferences Menu Option

  1. Click the Websites tab of Preferences.
  2. Click on Auto Play from the list of settings on the left of the window.

Orion Preferences Menu Option

There is a Default settings for all websites option at the top right of the window that can be set to:

  • Allow all Auto-Play
  • Stop Media with Sound
  • Never Auto-Play

There is also an area in the lower right of the window where you can add (+ button) or remove (- button) websites and give listed websites specific auto-play settings.

macOS Extensions Support

Table of Contents

Chrome and Firefox Extensions Support

Chrome & Firefox Logos

Orion supports browser extensions based on open-standard WebExtensions APIs. These are the same APIs that power browser extensions for Chrome and Firefox.

Orion currently supports about 70% of the WebExtensions APIs, and we add support for more all the time.

If you're having a problem with an extension in Orion, you can file a bug report in our feedback forum.

On top of that, we've built advanced security features that give our users granular control over extensions, far beyond what Chrome and Firefox offer. For example, you can choose to allow an extension to run only on certain websites.

By adopting the WebExtensions APIs, we've shown our support for creating a unified browser extension experience across all three major web rendering engines. We've ended up porting hundreds of APIs, one by one, that were never meant to work with WebKit. It took us a few years, but here we are!

Note that extensions may affect Orion's performance. You can measure the impact of your extensions on Orion performance by running SpeedoMeter 2.0 browser benchmark, with and without extensions (using Compatibility mode option in Orion to disable all extensions).

Installing Extensions

Many Chrome and Firefox extensions already work with Orion. And, even more of them will work in the future. You can install them from the Chrome or Firefox extension websites.

Orion also highlights some popular extensions for you to try:

  1. Click the Orion menu.
  2. Choose Popular Extensions.

macOS Popular Extensions

Choosing a Chrome Extension or a Firefox Extension

Orion supports both Chrome and Firefox extensions. Usually, they’re similar. Sometimes, an extension developer puts extra effort into one version, perhaps because they prefer that browser.

You can try both and use the one that works best for you. Orion is the only browser in the world that makes this choice possible!

Managing Extensions

  1. Click the Window menu.
  2. Click Extensions.

macOS Extensions Menu Choice

  1. From the Extensions management area, you can:
  • Use the Add Extension button to install Firefox, Chrome, or file-based extensions
  • Configure specific extensions
  • Disable one or more extensions
  • Uninstall one or more extensions

macOS Extensions Management

Safari Extensions Not Supported

Unfortunately, Apple uses closed, proprietary APIs for Safari extensions rather than WebExtensions APIs. So, it is not possible to use Safari extensions with Orion or any non-Safari browser.

Manifest v2 vs. v3 Chrome Extensions

The rollout of manifest v3 extensions in Chrome will not affect extensions in Orion.

Orion has its own implementation of the entire WebExtensions APIs collection. Different "manifests" are just numbers. We support WebExtensions APIs regardless of how Google decides to number them or change them. Manifest change impacts mainly Chromium clones. Orion will support both "manifest v2" and manifest v3" extensions in the future.

macOS Extensions Support

Table of Contents

Chrome and Firefox Extensions Support

Chrome & Firefox Logos

Orion supports browser extensions based on open-standard WebExtensions APIs. These are the same APIs that power browser extensions for Chrome and Firefox.

Orion currently supports about 70% of the WebExtensions APIs, and we add support for more all the time.

If you're having a problem with an extension in Orion, you can file a bug report in our feedback forum.

On top of that, we've built advanced security features that give our users granular control over extensions, far beyond what Chrome and Firefox offer. For example, you can choose to allow an extension to run only on certain websites.

By adopting the WebExtensions APIs, we've shown our support for creating a unified browser extension experience across all three major web rendering engines. We've ended up porting hundreds of APIs, one by one, that were never meant to work with WebKit. It took us a few years, but here we are!

Note that extensions may affect Orion's performance. You can measure the impact of your extensions on Orion performance by running SpeedoMeter 2.0 browser benchmark, with and without extensions (using Compatibility mode option in Orion to disable all extensions).

Installing Extensions

Many Chrome and Firefox extensions already work with Orion. And, even more of them will work in the future. You can install them from the Chrome or Firefox extension websites.

Orion also highlights some popular extensions for you to try:

  1. Click the Orion menu.
  2. Choose Popular Extensions.

macOS Popular Extensions

Choosing a Chrome Extension or a Firefox Extension

Orion supports both Chrome and Firefox extensions. Usually, they’re similar. Sometimes, an extension developer puts extra effort into one version, perhaps because they prefer that browser.

You can try both and use the one that works best for you. Orion is the only browser in the world that makes this choice possible!

Managing Extensions

  1. Click the Window menu.
  2. Click Extensions.

macOS Extensions Menu Choice

  1. From the Extensions management area, you can:
  • Use the Add Extension button to install Firefox, Chrome, or file-based extensions
  • Configure specific extensions
  • Disable one or more extensions
  • Uninstall one or more extensions

macOS Extensions Management

Safari Extensions Not Supported

Unfortunately, Apple uses closed, proprietary APIs for Safari extensions rather than WebExtensions APIs. So, it is not possible to use Safari extensions with Orion or any non-Safari browser.

Manifest v2 vs. v3 Chrome Extensions

The rollout of manifest v3 extensions in Chrome will not affect extensions in Orion.

Orion has its own implementation of the entire WebExtensions APIs collection. Different "manifests" are just numbers. We support WebExtensions APIs regardless of how Google decides to number them or change them. Manifest change impacts mainly Chromium clones. Orion will support both "manifest v2" and manifest v3" extensions in the future.

uBlock Origin on macOS

uBlock Origin Logo

Users of the uBlock Origin browser extension for content filtering are a passionate bunch. When we tell them Orion allows them to run uBlock in a WebKit-based browser on macOS, some have cried. But, they've assured us these are tears of joy!

Orion Content Blocking vs. uBlock Origin

Orion's built-in blocker is about 90% as efficient as uBlock Origin using default settings. But, our built-in blocker is faster. We designed it to be a great choice for most users.

For power users who want that last 10% with uBlock, we recommend disabling Orion's content blocker globally. Running both Orion blocking and uBlock may cause interference with each other.

To disable Orion's content blocking:

  1. In Orion, click the Orion menu and choose Preferences.

Orion Preferences Menu Option

  1. Click the Websites tab.
  2. Click Content Blockers in the list of options.
  3. Set "Default settings for all websites" to Off.

macOS Content Blockers Off

We recommend leaving Orion's tracking protection on. It uses WebKit's machine-learning-based technology and complements uBlock Origin to provide the best overall protection.

You can then install the uBlock Origin extension for Chrome or Firefox in Orion.

iOS & iPadOS Extensions

Table of Contents

Overview

Chrome & Firefox Logos

Orion is the first web browser to offer preliminary support for some Chrome and Firefox browser extensions on iOS and iPadOS.

We've ported hundreds of web extension APIs to run on top of the WebKit browser engine, which also runs on iOS and iPadOS.

We’re limited in the scope of APIs we can support. But, those that we do support will work out of the box, same as on desktop. And, you can one-click install them from the Chrome or Firefox extension websites.

iOS Extensions Management

    1. Tap the three-dot menu (•••) in the bottom-right corner of your screen.
  1. Tap Extensions.

iOS Extensions Menu Choice

  1. From the Extensions management area, you can:
  • Use the + button to install Firefox, Chrome, or file-based extensions
  • Disable one or more extensions
  • Uninstall one or more extensions

iOS Extensions Management Area

iPadOS Extensions Management

  1. Tap the three-dot menu (•••) in the upper-right corner of your screen.
  2. Tap Extensions.

iPadOS Extensions Menu Choice

  1. From the Extensions management area, you can:
  • Use the + button to install Firefox, Chrome, or file-based extensions
  • Disable one or more extensions
  • Uninstall one or more extensions

iPadOS Extensions Management Area

Safari Extensions Not Supported

Unfortunately, Apple uses closed, proprietary APIs for Safari extensions rather than WebExtensions APIs. So, it is not possible to use Safari extensions with Orion or any non-Safari browser.

1Password & Orion

1Password has not yet added support for Orion. Because of this, the 1Password browser extension does not function properly in Orion.

We have been told by 1Password that their development team is working on a new feature to allow users to choose their trusted browser. This will hopefully allow 1Password's browser extension to then work with Orion. 1Password has not given us any time estimate for when this new feature will be released.

In the meantime, 1Password 8 for macOS has a global autofill feature that does not require using any browser extension. Click inside a login field and press the command and \ keys at the same time.

Configure Ad & Tracking Blocking

Table of Contents

Why Use Blocking?

Over 700 million devices block online ads, creating the largest silent protest in human history. We too believe in a cleaner, more humane web. 

Orion blocks both first-party and third-party ads, trackers, and other annoyances by default. We do this to make your online adventures more enjoyable and more private. It also saves you time, battery, and data. Yes, it may occasionally break a site, but in most cases the benefit outweighs the risk.

If you wish, you can disable blocking either for a specific website or globally.

macOS Configuration

You can disable the content blocking or tracker prevention for a specific site using the gear icon on Orion's toolbar:

Settings for a Specific Website

To disable Orion's content blocking or tracking prevention globally:

  1. In Orion, click the Orion menu and choose Preferences.
  2. Click the Websites tab.
  3. Click Content Blockers or Tracking Protection in the list of options.
  4. Set "Default settings for all websites" to Off.

Content Blocking Settings

Tracking Prevention Settings

iOS and iPadOS Configuration

You can disable content blocking for a specific site by tapping the site's favicon image:

Tracking Prevention Settings

You can also configure content blocking globally:

  1. Tap the three-dot menu (•••).
  2. Tap Settings.
  3. You can use the Ads and Tracking section to enable either Basic tracking protection or Full tracking and advertising protection.

Websites Whitelisted From Blocking

Orion comes with a built-in content blocker that in rare cases can affect proper functionality of some websites. We maintain a whitelist of websites where content blocker will be turned off by default.

This list currently consists of:

  • browserbench.org - The content blocker interferes with JavaScript performance benchmarking. We decided it is best to have it off to measure the real speed of WebKit's JavaScript engine.
  • wizzair.com - The content blocker interferes with rendering of the website.

If you wish, you can enable blocking on any whitelisted website using the instructions above.

Configure Ad & Tracking Blocking

Table of Contents

Why Use Blocking?

Over 700 million devices block online ads, creating the largest silent protest in human history. We too believe in a cleaner, more humane web. 

Orion blocks both first-party and third-party ads, trackers, and other annoyances by default. We do this to make your online adventures more enjoyable and more private. It also saves you time, battery, and data. Yes, it may occasionally break a site, but in most cases the benefit outweighs the risk.

If you wish, you can disable blocking either for a specific website or globally.

macOS Configuration

You can disable the content blocking or tracker prevention for a specific site using the gear icon on Orion's toolbar:

Settings for a Specific Website

To disable Orion's content blocking or tracking prevention globally:

  1. In Orion, click the Orion menu and choose Preferences.
  2. Click the Websites tab.
  3. Click Content Blockers or Tracking Protection in the list of options.
  4. Set "Default settings for all websites" to Off.

Content Blocking Settings

Tracking Prevention Settings

iOS and iPadOS Configuration

You can disable content blocking for a specific site by tapping the site's favicon image:

Tracking Prevention Settings

You can also configure content blocking globally:

  1. Tap the three-dot menu (•••).
  2. Tap Settings.
  3. You can use the Ads and Tracking section to enable either Basic tracking protection or Full tracking and advertising protection.

Websites Whitelisted From Blocking

Orion comes with a built-in content blocker that in rare cases can affect proper functionality of some websites. We maintain a whitelist of websites where content blocker will be turned off by default.

This list currently consists of:

  • browserbench.org - The content blocker interferes with JavaScript performance benchmarking. We decided it is best to have it off to measure the real speed of WebKit's JavaScript engine.
  • wizzair.com - The content blocker interferes with rendering of the website.

If you wish, you can enable blocking on any whitelisted website using the instructions above.

Respecting Privacy

Orion has no built-in telemetry, so it can never "phone home" and risk exposing your data. Orion is truly and verifiably a privacy-respecting browser, unlike those that offer only an illusion of privacy.

Most browsers regularly "phone home" dozens or even hundreds times. Each request poses a security risk, no matter what information it sends, by potentially exposing your IP address and your browser fingerprint. Telemetry can also inadvertently leak personally identifiable information or corporate intelligence.

Telemetry of Browsers on Startup

The safest way to secure your private data is for your browser to be zero telemetry out of the box. Want to keep your information safe and private? Orion makes it possible!

Protecting Privacy

Web ads have steadily eroded the online experience with their layout crowding, page slowing, annoying popups, and insidious malware. Yet, most browsers do not block ads by default. Orion is different.

It comes with a state-of-the-art ad and tracking blocker that blocks first-party and third-party scripts and requests. That means that Orion always blocks all trackers by default. We combined WebKit's Intelligent Tracking Protection with "Easy Privacy" and other lists, providing double protection.

We use WebKit's content-blocking functionality and an optimized content-blocking database to maximize speed and minimize latency as well. Orion successfully blocks 99.9% of all ads, including YouTube ads, both on desktop and mobile.

Preventing Fingerprinting

Orion approaches this problem with the philosophy of "no fingerprinter running, no fingerprinting possible". This is because it is literally impossible to prevent fingerprinting from a sophisticated fingerprinter, if one is ever allowed to run. 

Even a simple JS/CSS based fingerprinter will bypass 99% of "protections" created by browsers, let alone something sophisticated such as GPU fingerprinting or audio driver fingerprinting. Literally, if Javascript/CSS is allowed to run in your browser, and a fingerprinter runs on the page, your browser will be fingerprinted.

So forget user agent/screen resolution/OS masking and other marketing talk used by browsers—this was maybe a thing 15 years ago, if ever. This does not protect you against sophisticated fingerprinters on the web.

The only efficient protection against fingerprinting is what Orion is doing - preventing any fingerprinter from running in the first place. Orion is the only browser on the market that comes with full first-party and third-party ad and tracking script blocking, built-in by default, making sure invasive fingerprinters never run on the page.

Orion vs. Safari

Safari is truly one of the best browsers you can use on macOS, and we’re grateful to Apple for creating such a solid foundation. By basing Orion on Safari’s tech stack, then adding productivity enhancements such as built-in ad-blocking, Orion can provide users with exactly what they need.

You want speed? Orion is currently the fastest Mac browser out there. We built a snappy, lightweight browser around Safari’s WebKit engine to accelerate your web experience.

What about privacy? Orion is a true zero-telemetry browser, with a powerful built-in ad and tracking blocker. Even with its default settings, Orion offers the highest possible privacy protection on the web.

And extensions! Unlike Safari, Orion has native support for both Chrome and Firefox extensions. This gives our users access to the largest extensions ecosystem in the world. With Orion, you can one-click install your favorite extensions directly from the web.

Orion vs. Safari

Safari is truly one of the best browsers you can use on macOS, and we’re grateful to Apple for creating such a solid foundation. By basing Orion on Safari’s tech stack, then adding productivity enhancements such as built-in ad-blocking, Orion can provide users with exactly what they need.

You want speed? Orion is currently the fastest Mac browser out there. We built a snappy, lightweight browser around Safari’s WebKit engine to accelerate your web experience.

What about privacy? Orion is a true zero-telemetry browser, with a powerful built-in ad and tracking blocker. Even with its default settings, Orion offers the highest possible privacy protection on the web.

And extensions! Unlike Safari, Orion has native support for both Chrome and Firefox extensions. This gives our users access to the largest extensions ecosystem in the world. With Orion, you can one-click install your favorite extensions directly from the web.

Orion vs. Chrome, Firefox, & Others

Google and Mozilla have made great technological strides over the past decades. We’re grateful for those efforts because they help us take the next step in browser evolution. Orion has superior performance, memory use, and battery efficiency compared to any non-WebKit browser on a macOS.

Orion is the first browser to have a zero-telemetry policy, meaning it will never "phone home" with any of your data. It also comes with a default blocker that knocks out ads and trackers, keeping websites respectful of our users.

As a native Mac app, Orion uses macOS components to give you the speed, look, and feel of a Mac app along with deep integration of native system technologies.

And, of course, Orion takes its users seriously. Because we’re zero telemetry, we design the product based only on what our users tell us. We’re here for you, and we’re doing this together!

Orion Speed

Orion is as fast or faster than Safari, because while both use the WebKit engine, we streamlined our browser for smoother use. Orion is much faster than non-WebKit browsers like Firefox or Chrome and its derivatives (Edge, Brave, Opera, etc.).

Orion Speedometer Score

Orion scores 326 on Speedometer 2.0 (using M1 MacBook Pro, with Orion's Compatibility mode ON) which is the fastest performance of any browser in existence (that we know of). 

On top of this, the native ad blocker makes Orion simply unrivaled in browsing speed. And, thanks to thoughtful optimizations, Orion feels faster and more responsive than Safari on slow and old Macs.

Memory Usage

Orion is lightweight with advanced memory-use technology. From single-tab optimizations to pinned tab management, we strive to minimize Orion's memory footprint. 

Orion Low Memory Usage vs. Safari

For power users, Orion has the best closed-tab management of all contemporary browsers. On default settings, Orion will consume 2x-3x less memory than mainstream choices after closing tabs. 

Orion Low Memory Usage vs. Other Browsers

Live stats

We have a very simple visualisation of Orion's active user count here.

Orion is zero telemetry so we do not know the actual number of users using it. This measures only the number of auto-update pings from users who have enabled auto updates and is the best first approximation we have.

Contributors

This entire documentation is open source and you can contribute by editing any page and creating a pull request. Check the instructions here.

The following contributors have helped improve Orion Browser documentation.

Thank you!

  • Marc
  • Zac
  • Seth
  • Alex Aidun
  • Liam
  • Vladimir Prelovac (vprelovac)
  • MemeScreen

If you feel you're missing from this list, feel free to add yourself in a pull request.


Special thanks to mdBook for a wonderful markdown doc generator.

Kudos

The Kagi community is vibrant groups of passionate users who make us stronger.

We would like to thank the following individuals for their contributions.

Localazy Translations

The following individuals have provided 10 or more translations and have therefore helped Kagi and Orion adoption worldwide.

  • Swedish: Siop, Ted Jangius
  • Portuguese: Tiago de Sousa, Rafael Rallo
  • French: Ori Berno, Séverin Hatt, Valentin Coindreau, httpjamesm, Charles Reeses, Sreonl, 0xCUBE
  • German: Tim Röring, Tristan Knies, Danman, gitarero164
  • Russian: Gena Rastorguev, Danman, Kiqo Bun (kiqobun)
  • Italian: Alberto Amatucci, Michael Simpson, federi95
  • Czech: Jonas Vacek, M_L_M, Jakub Dubec
  • Japanese: Hiroto Yajima
  • Dutch: toineenzo
  • Simplified Chinese: 宋泽晖
  • Polish: 0xCUBE