Create Tab Stacks

To create a Tab Stacks from open Tabs:

1. Open the Tab Switcher.
2. Tap Edit > Select Tabs in the bottom left corner.
3. Tap on all the tabs you want to add to the stack.
4. Tap Add to… > Add Tabs to New Stack.
5. Give the stack a name and select a color.
6. Tap Create Stack.

If you already have some stacks, you can also choose to add the selected tabs to one of the existing stacks instead of creating a new one.

To create a new Tab Stack from the Tab Bar:

1. Have the tab you want to include in the stack open as the active tab.
2. Long-press on it on the Tab Bar.
3. Select Add Tab to (New) Stack.
4. Give the stack a name and select a color.
5. Tap Create stack.
6. Add more tabs to the stack following the instructions in the next section.

To create a new Tab Stack from a link on a page:

1. Long-press on a link on a web page.
2. Select Open in New Tab Stack from the context menu.
3. Add more tabs to the stack following the instructions in the next section.

---

Add tabs to a stack

To add more tabs to a Tab Stack:

Option 1

1. Open the Tab Switcher.
2. Long-press on a tab.
3. Select Add Tab to Stack.
4. Tap on the stack you want to add the tab to.

Option 2

1. Open the Tab Switcher.
2. Tap on the stack to view the tabs in it.
3. Tap on the + at the bottom of the screen to open a new tab.
4. Go to the web page you want to view.

Option 3

1. Long-press on a tab on the Tab Bar.
2. Select Add Tab to Stack from the context menu.
3. Tap on the stack you want to add the tab to.

Option 4

1. Long-press on a tab on the Tab Bar.
2. Drag the tab over a stack.
3. Release your finger to add the tab to the stack.

Option 5

1. Long-press on a link on a web page.
2. Select Add Tab to Stack from the context menu.
3. Tap on the stack you want to add the tab to.

---

View and switch tabs

You can see your stacked tabs on the Tab Bar and in the Tab Switcher.

On the Tab Bar, stacked tabs are distinguishable by the border (in the stack’s color) surrounding the tabs in the group. Tapping the stack name will expand/collapse the stack.

To switch tabs, simply tap on the tab you want to view.

To view and switch tabs in Tab Stacks from the Tab Switcher:

1. Open the Tab Switcher.
2. Tap on the stack, which can be distinguished by the colorful circle and a stack name, as well as by previews of max 4 tabs in the stack.
3. Tap on the tab you want to view.

---

Rename Tab Stacks

To give the stack a different name from the Tab Bar:

1. Long press on the current stack name.
   If the stack doesn’t have a name, long press on the text saying how many tabs are in the stack.
2. Select Rename Stack.
3. Update the name.
4. Tap Done.

To give the stack a different name from the Tab Switcher:

1. Open the Tab Switcher.
2. Open the stack you want to rename.
3. Tap on the 3 dot menu in the top right corner and select Rename Stack.
4. Update the name.
5. Tap Done.

---

Change Tab Stacks’ colors

To choose a new color for the stack from the Tab Bar:

1. Long press on the current stack name.
   If the stack doesn’t have a name, long press on the text saying how many tabs are in the stack.
2. Select Rename Stack.
3. Pick a new color.
4. Tap Done.

To choose a new color for the stack from the Tab Switcher:

1. Open the Tab Switcher.
2. Open the stack you want to rename.
3. Tap on the 3 dot menu in the top right corner and select Rename Stack.
4. Pick a new color.
5. Tap Done.

---

Reorder tabs in a stack

To change the order of the stacked tabs from the Tab Bar.

1. Long-press on the tab you want to move.
2. Drag the tab to a new location on the Tab Bar.
3. Release your finger to finish the move.

To change the order of the stacked tabs from the Tab Switcher.

1. Open the Tab Switcher.
2. Open the stack you want to reorder.
3. Long-press on the tab you want to move.
4. Drag the tab to a new location in the stack.
5. Release your finger to finish the move.

---

Remove tabs from a stack

To remove a tab from a stack from the Tab Bar.

1. Long-press on the tab you want to move.
2. Drag the tab to a new location outside the stack on the Tab Bar.
3. Release your finger to finish the move.

To remove a tab from a stack from the Tab Switcher.

1. Open the Tab Switcher.
2. Open the stack you want to remove a tab from.
3. Long-press on the tab you want to move.
4. Select Move to Tab Stack > Remove From Group.

---

Close Tab Stack

To close all tabs in the stack and delete the stack:

Option 1

1. Open the Tab Switcher.
2. Tap on the Close button in the top right corner of the tab stack’s thumbnail.

Option 2

1. Open the Tab Switcher.
2. Long-press on the stack you want to delete.
3. Select Delete Stack from the context menu.

Option 3

1. On the Tab Bar, long-press on the stack you want to delete.
2. Select Delete Stack from the context menu.

You can use the browser’s screenshot tool, to capture the content on web pages. But if that content is a point in a video, then saving a frame from it directly is faster and gives you a better result than trying to draw a frame around the capture area.

To save a frame from a video as an image file:

1. Play the video and pause it at the point that you want to grab a screenshot of.
2. Right-click (in some cases double right-click) on the video to open the context menu.
3. Select Save Video Frame As.
4. Select the saved file’s destination folder.
5. Click Save.

In addition to saving a frame as an image on your computer, you can also just copy it.

To copy a frame from a video:

1. Play the video and pause it at the point that you want to grab a screenshot of.
2. Right-click (in some cases double right-click) on the video to open the context menu.
3. Select Copy Video Frame.
4. Paste the image where you want to use it.

The VPN feature in the Vivaldi browser is provided through a partnership between Vivaldi Technologies and Proton AG. Proton VPN is integrated into Vivaldi, allowing you to connect to a VPN server effortlessly with your Vivaldi account for free and access extra features after upgrading to a paid plan.

What is a VPN?

A virtual private network (VPN) is a service that changes how websites see your connection. Instead of seeing your connection coming from your normal IP address, they will see it coming from the IP address of the VPN provider, Proton in this case. The VPN connection encrypts traffic between you and the VPN service, so that other people who can normally view your unencrypted website traffic, cannot see the traffic. It will still be visible to anyone who can view the network communications between the VPN service and the website.

The VPN feature provided by Proton in Vivaldi is a type of VPN called a “secure web proxy”, meaning that it only affects the web traffic for Vivaldi, and does not affect the network communications of your other apps.

---

Why would you want a VPN?

A VPN can be used to temporarily cause a website to think you are connecting from a different country. This might be used in cases where a website does not allow access to people from your region. If using it for this purpose, you should use a new private browsing session, so that the website cannot use cookies, JavaScript storage or cache to recognize you from previous visits when you were not using the VPN.

A VPN might also be used to add a little more privacy from other users of your local network. However, it cannot shield the communication between the VPN service and the website, so it should not be used if complete privacy is needed.

---

Which Legal Jurisdiction is the service operated in?

Proton VPN, a service operated by Proton AG, is based in Switzerland, with company-owned servers located in Switzerland and Germany.

Account authentication is done by Vivaldi. Vivaldi Technologies is a Norwegian company with servers located in Iceland.

---

Connect to a VPN server

To use Proton VPN in Vivaldi, you need a Vivaldi account. If you don’t have an account yet, you can sign up here. If you already have a Proton account, you can use that for login as well.

When you’re connected to VPN, all your web traffic in Vivaldi will go through Proton VPN, but the connection does not extend to Vivaldi Mail.

To start using Proton VPN:

1. Click on the VPN button on the right side of the Address Bar.
2. Click Sign in with Vivaldi.
3. In the new tab, log in with your Vivaldi account credentials.
4. Allow Vivaldi to share your account’s recovery email address with Proton (only shown during first use).
5. Once logged in, click on the VPN button again.
6. Click Connect.

Once you’re connected, in Proton VPN’s menu, you’ll see that the “Unprotected” sign has changed to “Protected” and the button says “Disconnect” now. The VPN button on the Address Bar also changes color, allowing you to quickly check the connection status as you browse.

In addition, you’ll get a system notification letting you know that a connection was made. When you disconnect or the connection is dropped for some reason, you’ll also get a notification.

---

Proton VPN’s advanced features

To access additional features:

1. Open the VPN menu.
2. Click on Features near the top left corner of the menu.
3. Toggle features on and off as needed.

Auto Connect

With auto connect enabled, you’ll be reconnected to VPN automatically every time you open the browser.

Please note that because of how extensions are loaded after the browser starts, the VPN will be initialized a short period (a few seconds) after Vivaldi starts. Immediately after starting, Vivaldi will load the active tab without being able to use the VPN.

WebRTC leak protection

WebRTC leak protection stops your browser from leaking your IP address to websites and apps using WebRTC. This may affect video calling or live-streaming performance on some websites.

Notifications

When notifications are enabled, you’ll receive system notifications every time a connection is made or disconnected.

Extra features, such as Secure Core and Split Tunneling, are available with a paid plan.

---

Upgrade plan

With the free account, you’ll be connected to the fastest server for your location. To choose a location yourself, you need to upgrade to a paid plan. In addition to being able to choose a connection location, with a paid plan you’ll get access to other premium Proton VPN features and Proton’s services. Learn more about Proton’s plans.

To view and select a plan:

1. Open the VPN extension menu.
2. Click on Settings in the bottom left corner of the extension’s menu.
3. Click on Manage subscription.
4. Select a plan.
5. Fill out the payment details and make the payment.

By upgrading to a paid plan with a Vivaldi account you’ll be contributing to Vivaldi and supporting us in building a better browser.

---

Stop using VPN

To disconnect from a VPN server:

1. Click on the VPN button on the right side of the Address Bar.
2. Click Disconnect.

To log out of the extension:

1. Click on the VPN button on the right side of the Address Bar.
2. Click on Settings in the bottom left corner of the extension’s menu.
3. Click Sign out at the bottom of the extension’s menu.
4. Confirm your decision by clicking OK.

To disable VPN altogether:

1. Go to Settings > Privacy and Security > Privacy > Proton VPN.
2. Disable Enable Proton VPN.

---

Troubleshooting issues

For additional information about Proton VPN, visit their Help pages on https://protonvpn.com/support/.

Unable to log in or register a Vivaldi account

If you’re not able to log in to your Vivaldi account or have trouble creating an account, take a look at our Help page about Registration and login issues.

Connection issues

When you’ve connected to VPN, but want to verify that it’s working, follow the instructions in this blog post by Proton.

Service availability

To see the status of Proton’s services, check their status page.

“Unable to find appropriate server”

If you see this error message after clicking “Connect”, log out of your account and back in. Then try connecting again.

Address Field is a section on the Address Bar where you can see the URL of the page you’re currently on. There you can enter a new web page link to navigate to the website or a search term to see search results. But the Address Field in Vivaldi has a lot more to offer. Continue reading to learn all about the Address Field.

On the Address Field you’ll find:

•  Site Info and Content blocker – check your connection security and access Site Settings, as well as change the tracker and ad blocking level for the website.
• Address and Search field – type in the link you want to visit or a search term you want to look up.
•  Reload – if you’ve scrolled too far down and swiping down to reload isn’t reasonable, you can tap on the Reload button.

Address Field settings

To move the Address Bar to the bottom of the screen together with the Tab Bar:

1. Go to  Vivaldi menu > Settings > Tabs.
2. Toggle on/off Address Bar At Bottom.

Address Field Options

• Show X for removing suggestions – To remove irrelevant suggestions in the drop-down menu you can long-press on an entry and tap OK in the confirmation dialog. Alternatively, you can enable Show X for removing suggestions in Settings > Address Bar > Address Field Options to show an X button next to suggestions that can be hidden.
• Show Typed History – It can be handy to see what you previously typed in the Address Field and tap on the suggestion to get to results faster. If you’d rather not see your typed history, you can disable it from Settings > Address Bar > Address Field Options.

Address Field Suggestions

In Settings > Address Bar > Address Field Suggestions, you can decide whether you see suggestions as you type in the Address Field from your browsing History, Bookmarks, and Direct Match, and more.

Vivaldi Social can be accessed from any web browser by logging in on the link https://social.vivaldi.net/. Mastodon also supports Progressive Web Apps.

In addition to the web version, you can access your Vivaldi Social account from various apps built for Mastodon. Check out the selection of available apps for both mobile and desktop on https://joinmastodon.org/apps.

To login to Vivaldi Social from an app:

1. Install the app of your choice.
2. Select Log In or the option that allows you to pick your Mastodon server.
3. Enter Vivaldi Social’s domain name – social.vivaldi.net.
4. Select logging in with vivaldi.net.
5. Enter your Vivaldi account’s username and password.
6. Give the app permission to access your account and its data.

The steps you need to follow may differ slightly from what’s listed here, depending on how the app’s onboarding process has been implemented. Furthermore, the in-app experience will likely be a little different from the web version as well. Explore the different apps to find the one you like best.

In general, mobile devices, such as smartphones and tablets, have smaller screens than laptops and desktop setups. This usually means that user interface elements and web contents are much smaller and that can make browsing on mobile more difficult. Luckily in Vivaldi on iOS you can change the zoom level to make reading easier.

Zoom in on web pages

To change the text size:

1. While you’re on the page, go to the Vivaldi menu > Zoom text.
2. Tap on the – or + buttons to find the best zoom level.
3. Tap Done.

To reset the zoom level.

1. While you’re on the page, go to the Vivaldi menu > Zoom text.
2. Tap Reset or tap on the – or + buttons to go back to 100%.
3. Tap Done.

Break down language barriers and open up the web with Vivaldi Translate.

Accessing the Translate Panel

To open the Translate Panel:

1. Tap on the Panel button.
2. Tap on the Translate panel button.

---

Translate text

To translate text in the panel:

1. Open the Translate Panel.
2. Type or paste the text into the input field.
3. Tap Translate.

If the language isn’t detected automatically, tap on Auto Detected at the bottom of the panel and select a language. You can also change the language the text is translated into.

Clear translation

When you’re done with the translation or want to translate something else, tap  Clear below the output field.

---

Full page translations

To translate all text on a web page

1. Either, tap on the notification offering to translate the web page, on the Translate button on the Address Bar (see screenshot), or go to the Vivaldi menu > Translate.
2. Review the translation’s languages.
3. Tap Translate.

In addition, you can select whether to:

• Always translate pages in that language.
• Never translate pages in that language.
• Offer to translate that language, but never on the site you’re currently on.

---

Translate text from a web page

To translate only some sections of the web page:

1. Highlight the text you want to translate.
2. Tap on Vivaldi Translate in the small menu that appears.

The Translate Panel will open with both the source text and the translation. If your selected text is very short, you may have to select the source language manually.

---

Translation settings

By default, when you translate selected text, the translation will be displayed in a dialog. If you prefer to open the translation in the Translate Panel:

1. Go to Vivaldi menu > Settings > Content Settings.
2. And enable Prefer Translate Panel.

To review and edit which languages get offered to translate the web page and which do not:

1. Go to Vivaldi menu > Settings > Accept Languages.
2. Add and edit languages for which translations will or will not be offered for.

Tap on Edit in the bottom right corner to reorder and remove languages.

Disable translation offers

If you don’t want to see notifications on web pages offering to translate the content for you:

1. Go to Vivaldi menu > Settings > Accept Languages.
2. Disable Translate pages.

---

Translation history

To view past translations, tap on the clock button near the bottom of the panel.

Delete history

To delete a single translation history entry

1. Open the Translation History.
2. Long-press on the entry you want to delete.
3. Select Delete from the context menu.

To delete multiple entries:

1. Open the Translation History.
2. Tap on Edit in the bottom right corner.
3. Select the entries you want to delete.
4. Tap on More.
5. Select Delete Selected from the menu.

To delete all history:

1. Open the Translation History.
2. Tap on Edit in the bottom right corner.
3. Tap on Delete all in the bottom left corner.

Progressive Web Apps (PWA) are websites that can be installed as independent applications. They can be opened from shortcuts and used in their own window separate from the main browser.

Install a Progressive Web App

To install a website as a PWA:

1. Open the web page in Vivaldi.
2. Go to the  Vivaldi Menu > Add Page To > Home screen.
3. Select Install.
4. Tap Install in the confirmation dialog.

If the site doesn’t support PWAs, you’ll be offered to create a shortcut instead. While PWAs open in their own window, tapping on the shortcut will open the saved site in a new tab in the main app window.

---

Open links from Progressive Web Apps in the main browser

To open a link from a PWA as a new tab in the main browser window:

1. Long press on a link to open the context menu.
2. Select “Open in Vivaldi Browser”.

---

Delete Progressive Web Apps and Home Screen Shortcuts

To uninstall a PWA or delete a shortcut:

1. Long press on the PWA/shortcut icon on your home screen.
2. Select Remove.

Vivaldi’s privacy and security settings give you solid control over safeguarding your private data.

By default, each setting has been enabled or disabled based on what we believe is in our users’ best interest, but you have the option to change each setting in Settings > Privacy and Security.

Always Use Secure Connection (HTTPS)

To always load websites using the secure HTTPS protocol instead of the less secure HTTP:

1. Go to Settings > Privacy and Security.
2. Enable Always Use Secure Connection (HTTPS).

By default, when you do not enable this setting, Vivaldi will check if websites can be accessed securely and use the secure connection if possible. As a result, for most websites, this setting is not actually needed. However, you may choose to enable this setting if you absolutely never want to use websites that do not offer HTTPS, without clicking on a warning message first.

Note that this setting will sometimes cause websites that do offer HTTPS to show a warning if the website responds very slowly to HTTPS requests since Vivaldi cannot tell if this is the website not supporting it, or just supporting it very slowly. Only enable this setting if you are willing to accept this annoyance!

---

Lock Private tabs when you leave Vivaldi

When you leave Private Tabs open for longer, you can lock them for additional privacy. Next time you open Vivaldi and wish to view a private tab, you’ll first be asked for your phone’s or tablet’s screen lock PIN, password, pattern, etc.

To enable or disable locking of Private Tabs:

1. Go to the Vivaldi menu > Settings > Privacy and Security.
2. Toggle on Lock Private tabs when you leave Vivaldi.
3. Verify yourself with your device’s unlock method.

---

Access payment methods

You can save your credit card details in Vivaldi to make online transactions faster in Settings > Payment methods. Websites can check whether you have payment methods saved. To block them from doing so:

1. Go to the Vivaldi menu > Settings > Privacy and Security.
2. Toggle off Access payment methods.

---

Preload pages

Preloading pages that Vivaldi thinks you’re likely to visit can help make browsing faster. Preloading is enabled by default.

To change preloading settings:

1. Go to the Vivaldi menu > Settings > Privacy and Security > Preload Pages.
2. Select between no preloading and standard preloading.

When Cookies are allowed, they may be used for preloading.

When a Google site asks to privately preload links on their page, Vivaldi encrypts and preloads pages through Google servers without cookies. This hides your identity from the preloaded site. Because the preloaded pages are encrypted, and the site linking to the pages is a Google site, Google servers don’t receive new information when privately preloading these pages.

---

Use secure DNS

In order to open a website, its IP address has to be fetched via a DNS (Domain Name System) provider. Secure DNS accesses DNS servers over HTTPS and encrypts all the data being transferred between your device and the DNS servers.

To choose a DNS provider:

1. Go to the Vivaldi menu > Settings > Privacy and Security > Use secure DNS.
2. Select between your current internet service provider or:
   • Custom (enter your preferred provider’s URL manually),
   • Google (Public DNS),
   • CleanBrowsing (Family Filter),
   • OpenDNS,
   • Cloudflare (1.1.1.1), or
   • NextDNS.

---

Send a “Do Not Track” request

You may enable the option Send “Do Not Track” request. It’s a polite way of asking websites not to set tracking cookies. However, they can simply ignore it, and in most cases, the ones you want to avoid will be the ones who do not respect your request.

---

Touch to Search

When you’ve chosen Google as your default Search Engine, you can make use of the Touch to Search feature. It allows you to learn about topics without leaving the page.

To use Touch to Search:

1. Highlight the text you want to use as a search term by long pressing on the word and dragging the bubbles on either side of the word to expand the search term.
2. Open the search results view by sliding it up from the bottom of the screen.
3. Tap on a search result to open the web page in a new tab.
4. Swipe down to close the search.

To get more accurate results, you can allow Google to include surrounding text in the searches as well. To enable it:

1. Go to Vivaldi menu > Settings > Privacy and Security > Touch to Search.
2. Enable Include surrounding text in Google searches.

To disable Touch to Search (enabled by default):

1. Go to Vivaldi menu > Settings > Privacy and Security > Touch to Search.
2. Tap the toggle button to disable the feature.

---

Delete browsing data

To delete your browsing history:

1. Open the History Panel and tap on  Clear Data on the right side of the bottom toolbar.
   Alternatively, open the Vivaldi menu > Settings > Privacy and security> Delete browsing data.
2. Pick a time range.
3. Select the data types you want to delete (take a look at the Advanced section as well).
4. Tap Delete data.

---

Clear session browsing data on exit

If you want to delete your browsing history and other data when you’re finished using the app, you can have it automatically deleted on exit. To enable the settings:

1. Go to the Vivaldi menu > Settings > Privacy and security > Clear session browsing data on exit.
2. Toggle on the setting.
3. Choose which data types you want to delete:
   • Browsing history.
   • Cookies and site data.
   • Cached images and files.
   • Close open tabs.

It’s not enough to minimize the app or remove it from the app switcher menu to exit the browser. To exit Vivaldi:

1. Go to the Vivaldi menu.
2. Scroll to the bottom of the menu.
3. Select Exit.

---

Broadcast IP for best WebRTC performance

Broadcasting IP for Best WebRTC (Web Real-Time Communication) performance is most relevant for users browsing over a VPN connection, who want to hide their IP even from websites using WebRTC to check real IP addresses.

In Vivaldi, broadcasting has been enabled by default, meaning websites can see your IP address, though, often just the internal network IP address. Disabling this setting will increase your privacy, but can cause issues with how websites function.

In order to improve the result of ad monetization for sites where a user has decided to enable ads, Vivaldi has now included support for ad attribution. You can read more about why this change was implemented here.

This page mainly aims to describe how Ad Attribution is implemented and explain the choices that led to this implementation. The goal is to be fully transparent about what may be allowed through and when.

As with the rest of the ad blocker code, this implementation is fully available as part of our released source code bundles. This allows you to fully verify that our implementation is as described here and in other articles.

Allow Ad Attribution rules

The main challenge with ad monetization is that many ad providers rely on known trackers in order to prevent click fraud and ensure that conversion has occurred before paying out. The only solution to this is unfortunately to allow such trackers to load, regardless of what our tracker blocking lists say. However, we also want to ensure that these trackers are not loaded as part of general browsing.

In order to satisfy all these requirements, I have extended the normal ad blocker rules format. This is the same format used by all popular ad-blockers and rules lists. The extended format consists of three new options that will be detailed below.

This implementation was chosen as it allows us to reuse most of the ad-blocker functionality to effectively accomplish the goal of ad attribution while also allowing us to use the automatic update mechanism coming with ad blocker rules lists. This ensures that we can promptly fix any mistake.

How it works

Ensuring that ad attribution works is a complex task that takes multiple steps to accomplish. In general, the focus is on the site which uses ads for support, however most of the work is done after clicking on a given ad. As part of the implementation, we go through the following states.

1. Navigating to a site which the user wants to support.

When this occurs, the ad attribution implementation records that it should be looking for ad clicks. We say that it is primed.

Ad attribution is normally primed on any site where the ad blocker is disabled, regardless of the state of the tracker blocker. Priming ad attribution means we will check whether the next navigation is an ad click. It has no other effect.

In order to be able to support ad attribution for our partner search engines even when ad blocking is enabled for all sites, we introduced the attribute-ads rule option:

@@||partner-site.example.com/page-i-want-to-Support$attribute-ads

This causes ad attribution to be primed on the matching page, regardless of the ad blocker status. In practice, we would also add a document option (identical to the document allow rules supported by AdBlockPlus), in order to allow the partner site to show ads:

@@||partner-site.example.com/page-i-want-to-Support$attribute-ads,document

2. Matching an ad when Ad Attribution is primed.

When this occurs, the ad attribution implementation will examine the URL being loaded as well as the URLs of any redirections which occurs as part of loading.

If none of those URLs matches a known ad, then ad attribution remains disabled. It may be primed again if the site where the user ends up is one the user wants to support.

If the URL matches a known ad, then ad attribution moves to the next stage and the process continues.

The ad-query-trigger option is used to indicate that a rule should be used to match ad URLs:

||advertiser.example.com/ad-URL$ad-query-trigger=&click-id-param=|&other-click-id-param=

The ad-query-trigger option takes a value that is composed of several query string fragments, separated by |.

Once a document matching the pattern for an ad-query-trigger rule was reached, directly or via redirect, further redirections will be examined. For those redirections, the query string of the URL will be examined. If it contains any of the strings provided as value to the option, ad attribution will be fully enabled and the origin of the matching URL will be stored as the ad landing origin for this tab.

The ad-query-trigger option requires a pattern that provides a domain name in the ad URL pattern. This means, the pattern should be host-anchored and the domain should be followed by ^,/ or ?

Once ad attribution is enabled for a specific tab and origin, that state is preserved so long as the tab navigates within this same origin. Navigating to a different origin will cause ad attribution to be disabled, but it’s state will be preserved for a half hour. Further navigations within the deadline extend it to a half hour. If the deadline passes, further navigations outside the original origin clear the state fully. Navigating back to the landing origin will re-enable ad attribution.

The ad attribution state is normally confined to the tab where it was enabled. However, a same-origin navigation to a new tab from a tab where it is enabled will preserve its state.

Ad attribution also always gets disabled seven days after being triggered.

3.Matching trackers when ad attribution is enabled

When ad attribution is enabled, it examines resources loaded on pages whose origin match the landing origin. In order to indicate which resources should be allowed for ad attribution, rules with the ad-attribution-tracker option are used.

@@||advertiser.example.org/track-click$ad-attribution-tracker=advertiser.example.com/&click-id-param=|advertiser.example.net/&ad_id=

The body of this rule matches the url of the resource itself, while the value of the ad-attribution-tracker option provides the context in which it should be allowed. The value of this option consists of a pairs of domain/query-fragment separated by |. The domain part is matched against the domain of the ad that was clicked (the ad itself, not its landing origin). The query-fragment is matched against the query fragment used to enable ad attribution. A pair matches if both components are a match. This rule matches if the resource url matches and any of the domain/query-fragment pair is a match. When a tracker is allowed this way, it bypasses blocking both in the ad blocker and the tracker blocker.

These rules are currently only available in the “Allow Ads from our Partners” list that is provided by Vivaldi. This is to avoid situations where they may be employed in malicious rules lists. You can examine our list to learn of which partner sites have ad attribution enabled and which trackers are allowed as a result here.