programs.firefox.profiles.<name>.search.engines

Attribute set of search engine configurations. Engines that only have metaData specified will be treated as builtin to Firefox.

See SearchEngine.jsm in Firefox's source for available options. We maintain a mapping to let you specify all options in the referenced link without underscores, but it may fall out of date with future options.

Note, icon is also a special option added by Home Manager to make it convenient to specify absolute icon paths.

Declarations

Type

attribute set of attribute set of (JSON value)

Default

{ }

Example

{
  nix-packages = {
    name = "Nix Packages";
    urls = [{
      template = "https://search.nixos.org/packages";
      params = [
        { name = "type"; value = "packages"; }
        { name = "query"; value = "{searchTerms}"; }
      ];
    }];

    icon = "${pkgs.nixos-icons}/share/icons/hicolor/scalable/apps/nix-snowflake.svg";
    definedAliases = [ "@np" ];
  };

  nixos-wiki = {
    name = "NixOS Wiki";
    urls = [{ template = "https://wiki.nixos.org/w/index.php?search={searchTerms}"; }];
    iconMapObj."16" = "https://wiki.nixos.org/favicon.ico";
    definedAliases = [ "@nw" ];
  };

  bing.metaData.hidden = true;
  google.metaData.alias = "@g"; # builtin engines only support specifying one additional alias
}