Extensions/ Add-on Guidelines
This document, by our operations team, outlines the specific requirements & guidelines for the use of the Search API and/ or Search URL licensed to you by CodeFuel as within your extension implementation. These requirements & guidelines do not replace or derogate from any of your obligations in the agreement you signed with CodeFuel; but are intended to provide guidance as to high level do’s and don’ts for Extension(s) on the Chrome Webstore (“CWS”), Mozilla Firefox extensions / Add-on and Safari Add-ons.
The Publisher’s Compliance Guidelines* dated December 2, 2014 and the API Guidelines, where applicable to you, are an integral part of this document. If you have any questions regarding any of these Guidelines, please contact your account manager at CodeFuel.
These guidelines are not an exhaustive list and CodeFuel is entitled to use its discretion when evaluating your website/ application and may replace/edit/expand the guidelines at any time. For further information on how to integrate your product with CodeFuel please reference the corresponding integration guidelines provided by your account manager.
The browser’s issued several guidelines regarding extensions on their stores. It is your responsibly to keep yourself up-to-date with any Google, Mozilla, Safari, edge or Opera releases, updates, new rules and guidelines.
Good resources include (but are not limited to) are:
- Google Blog and Google developer’s sites:
The descriptions below is a non exhaustive list, and merely reflects our interpretation to these guidelines:
- The site/ app must comply with Bing Ads User Safety and Privacy Guidelines. Implementation must comply with the Software and Downloads guidelines and our Bundling & Integration Guidelines
Restriction on activities
- Extensions can only change the user’s search settings via the official browser setting override API.
- Single purpose: Extensions on CWS are limited to a single purpose (for example: weather extension). Extensions that provides search or change the user’s search setting, can change only the following settings:
- One search assets (setting) only: if the extension comprised of a non search purpose, it can only change one search setting (e.g.: a weather extension can change the user’s NT only).
- Multiple search assets: provided that the only purpose of the extension is search, it can change multiple settings (for example: an extension that changes both Newt Tab and provide search from the Omnibox/Default search, and whose sole purpose is to provide these search assets. However, please note that if an extension provides search to both New Tab and Default Search, AND provides weather data, this would not be considered as an extension that meets the guidelines).
- Resizing browser windows without the user’s informed consent is prohibited.
- Disabling back buttons, or otherwise interfering with a user’s ability to navigate is not permitted. You must use a clear indication to enable the user to close the browser or any interface window.
- An extension cannot collect browsing activity UNLESS it complies with the following:
6.1 It is described on the CWS page. The collection of the web browsing activity is done only to the extent required for a user facing feature.
General Do’s and Don’ts
- The Extension must not change the user’s search settings or offer any functionality without the user’s explicit consent. Such functionality must be disclosed on the first download interaction with the user (sich as: marketing material – Ad, landing page, CWS page, and if the installation occurs from another methods- it must be pre-approved by CodeFuel).
The user MUST be able to modify settings manually from the chrome://settings page, under the following sections: ‘On startup’ ; ‘Appearance’ and ‘Search’ (see images below)
It is also highly recommended to allow the users to modify settings manually from the extension’s browser action.
You must provide an explanation to the user on how to uninstall the extension. It is highly recommended to provide the users the ability to access uninstallation (or instructions on how to uninstall) from the extension’s browser action.
- TOU/ EULA should describe:
- The extension and its value to the user
- Which resets are being requested (homepage /New Tab/ Default Search/ All three) and what product offerings are prompting these resets
- An explanation on how user can modify settings manually.
- Any change to the user’s search settings (including homepage resets, default search sets and new tab offerings) without the user’s explicit consent- is prohibited
- Prompting additional offering dialog after the user has declined the offering for a same extension is not allowed.
- Disabling or altering any software on a user’s computer without user consent- is prohibited
- Using the Web Search Provider’s logo (Bing/ other) is prohibited.
- The extension (including its promotion, distribution, domain name, and any part thereof), must not violate any intellectual property or other proprietary rights.
Your extension may be distributed by one or more of the following ways: Landing Page, bundled with other software, banner (ad), or directly via the store.
A landing page of an extension must clearly explain what the extension is, including its name, key functionality, main effects on the user’s computer, and whether it includes other monetization methods.
- Other requirements are available under the landing page chapter
- Each offer screen should provide users with a clear way to accept or decline the offer.
- The presentation of the ‘accept and decline’ options within an offer screen shall be of equal prominence.
- An offer screen must have the brand of the extension offered in the screen and must not mislead the user as to which product is actually being offered.
- The name of the product shown in the offer screen during the installation must be identical to the product name in the OS, browser libraries and removal dialogs, as applicable.
- If the bundle has more than one bundled product, then there must be a ‘skip’ option.
- Each bundled product should be clearly marked as optional and/or promoted content. For example:
- Additional offer
- Promotional offer
- Optional offer
- Promoted content
- For more information on bundling guidelines -see Bundling and Integration Guidelines.
Homepage/ New Tab Pages:
- Must include clear and prominent branding of the extension owner. (A copyright notice is not considered as branding).
- In some cases, and subject to CodeFuel prior approval, the extension’s brand/ logo can be used (instead of the publisher’s brand).
- Branding must be consistent throughout user experience, reset offers, install flow and in settings.
Company contact must include: physical address, phone number and email.
- Global requests must adhere to local language requirements for international markets.
- You must enable the user to turn off or disable the extension features (favorite buttons/ icons) from the New Tab and transform its New Tab to a simple plane page without the additional features.
- You should include a clear call to action near or in the searchbox (e.g. ‘Search’. However, you may not use the name of the Web Search Provider).
- For special requirements and guidelines regarding Customized/ Hosted SERP – please see the relevant section in the Search API Guidelines and our best practices.
Last update: April 2020