---
title: Add parameters to your HubSpot Site Search Input module
description: Customise the parameters on your site search input module to filter by type, language, domain... etc.
image: https://www.stephanieogaygarcia.com/hubfs/Website%20Imagery/Stephanie%20OGay%20Garcia%20-%20HubSpot%20CMS%20Designer%20and%20Developer%20L.png
---

[Skip to Content](https://www.stephanieogaygarcia.com/hubspot-website-development/add-parameters-to-your-hubspot-site-search-input-module#main-content)

[![Stephanie O'Gay Garcia](https://www.stephanieogaygarcia.com/hubfs/Logos/stephanieogaygarcia_logo.svg "Stephanie O'Gay Garcia")](https://www.stephanieogaygarcia.com/)

Open Navigation

- [About](https://www.stephanieogaygarcia.com/about)
- [Services](https://www.stephanieogaygarcia.com/services)
- [Products](https://www.stephanieogaygarcia.com/shop)
- [Work](https://www.stephanieogaygarcia.com/portfolio-work)
- [Blog](https://www.stephanieogaygarcia.com/hubspot-website-development)
- [Contact](https://www.stephanieogaygarcia.com/contact)

- [About](https://www.stephanieogaygarcia.com/about)
- [Services](https://www.stephanieogaygarcia.com/services)
- [Products](https://www.stephanieogaygarcia.com/shop)
- [Work](https://www.stephanieogaygarcia.com/portfolio-work)
- [Blog](https://www.stephanieogaygarcia.com/hubspot-website-development)
- [Contact](https://www.stephanieogaygarcia.com/contact)

[HubSpot Sprocket Icon  HubSpot Website Development ](https://www.stephanieogaygarcia.com/hubspot-website-development)

[site search](https://www.stephanieogaygarcia.com/hubspot-website-development/tag/site-search)

# Add parameters to your HubSpot Site Search Input module

 Technical Difficulty: Intermediate

 Written by [ Stephanie O'Gay Garcia ](https://www.stephanieogaygarcia.com/hubspot-website-development/author/stephanie-ogay-garcia)

 First Published:  September 17, 2019

 Last Updated:  June 4, 2025

⚠️ Note that this post hasn't been updated for at least a year and the information may be outdated, proceed with caution! *(Last updated: June 4, 2025)*

You can customise the [Site Search Input](https://developers.hubspot.com/docs/guides/cms/content/content-search#site-search-input) module on your HubSpot account to include additional parameters in your search, such as the content type or language. 

## Where do I find the HubSpot site search module?

You can clone the module to customise it in one of two ways:

- Directly from Design Tools
- Through the CMS CLI

### a. From Design Tools

If you navigate to your portal's sidebar > Content > Design Tools you can find the module by:

- Navigating to @hubspot/search_input
- Searching for "Site Search Input" in the "Search assets" search bar

While you can't make updates to default modules, you can click on the "Clone module" button to create your own customisable version:

![Site Search Input - Clone Module](https://www.stephanieogaygarcia.com/hs-fs/hubfs/HubSpot%20CMS%20Development/Site%20Search%20Input%20-%20Clone%20Module.jpg?width=1061&name=Site%20Search%20Input%20-%20Clone%20Module.jpg)

 

### b. From the CMS CLI

If you're developing locally on the CMS CLI, you can use `hs fetch @hubspot/search_input.module` to fetch the module. You can optionally set the path to the local directory you would like the files to be placed (e.g. `hs fetch @hubspot/search_input.module my-theme/modules/search_input_custom.module`)

 

## How do I customise the site search parameters?

As of June 2025, the default HTML + HubL in the custom module looks like this:

```
<div class="hs-search-field">

    <div class="hs-search-field__bar">
      <form data-hs-do-not-collect="true" action="{{ search_page|escape_url }}">
        {% if module.field_label %}
          <label for="term">{{ module.field_label|sanitize_html }}</label>
        {% endif %}
        <input type="text" class="hs-search-field__input" name="term" autocomplete="off" aria-label="{{ module.field_label|escape_attr || "Search" }}" placeholder="{{ module.placeholder|escape_attr }}">

        {% for type in content_types %}
          {% if module.content_types[type.field_name] is truthy %}
            <input type="hidden" name="type" value="{{ type.content_type }}">
          {% endif %}
        {% endfor %}

        {% if module.include_search_button %}
          <button aria-label="Search">{% icon name="search" style="solid" %}</button>
        {% endif %}
      </form>
    </div>
    <ul class="hs-search-field__suggestions"></ul>
</div>
```

### Default parameters

Within the `<form>` element, there are several `<input>` elements. The first (with class `hs-search-field__input`), is the actual search bar.

Below there is a content_types repeater that adds several `<input>` elements depending on which content types have been selected.

### Custom parameters

To add your own custom parameters, you can add additional `<input>` elements. To do so:

1. Add a new `<input>` element
2. Set the type to "hidden" (`type="hidden"`)
3. Set the name to the parameter you would like to use (e.g. `name="language"`) - you can find [a list of parameters](https://www.stephanieogaygarcia.com/hubspot-website-development/add-parameters-to-your-hubspot-site-search-input-module#available-parameters) below
4. Set the value to the parameter's value (e.g. `value="es"`)

For example, to specify that only Spanish pages should be searched, you would add this input tag:

```
<input type="hidden" name="language" value="es">
```

And to specify that only a specific blog should be searched, you would add in this input tag, where "12345" is your [HubSpot blog ID](https://www.stephanieogaygarcia.com/hubspot-cms-development/how-to-find-your-hubspot-blog-id): 

```
<input type="hidden" name="groupId" value="12345">
```

You can add these under the content_types repeater so that your code looks like this:

```
<div class="hs-search-field">

    <div class="hs-search-field__bar">
      <form data-hs-do-not-collect="true" action="{{ search_page|escape_url }}">
        {% if module.field_label %}
          <label for="term">{{ module.field_label|sanitize_html }}</label>
        {% endif %}
        <input type="text" class="hs-search-field__input" name="term" autocomplete="off" aria-label="{{ module.field_label|escape_attr || "Search" }}" placeholder="{{ module.placeholder|escape_attr }}">

        {% for type in content_types %}
          {% if module.content_types[type.field_name] is truthy %}
            <input type="hidden" name="type" value="{{ type.content_type }}">
          {% endif %}
        {% endfor %}

        {# Custom parameters #}
        <input type="hidden" name="language" value="es">
        <input type="hidden" name="groupId" value="12345">

        {% if module.include_search_button %}
          <button aria-label="Search">{% icon name="search" style="solid" %}</button>
        {% endif %}
      </form>
    </div>
    <ul class="hs-search-field__suggestions"></ul>
</div>
```

### Available parameters

You can add in parameters below for the following: 

- **Type (`name="type"`): **Specifies the type of content to search. Can be one or more of `SITE_PAGE`, `LANDING_PAGE`, `BLOG_POST`, `LISTING_PAGE`, and `KNOWLEDGE_ARTICLE`. Defaults to all content types except `LANDING_PAGE` and `KNOWLEDGE_ARTICLE`
- **Domain (`name="domain"`):** Specifies the domain(s) to be searched. Can be one or more of the portal's connected domains. Defaults to all domains.
- **Language (`name="language"`):** Specifies the language of content to be searched. This parameter should obey the ISO639-1 format (e.g. es for Spanish).
- **Property (`name="property"`):** Specifies which properties to search for (defaulting to all properties). Options are `title`, `description`, and `html`. For blog posts, additional search properties are `author_full_name`, `author_handle`, and `tag`.
- **Group ID (`name="groupId"`):** Specifies which blog(s) to be searched by blog ID. Can be used multiple times to search more than one blog.
- **Table ID (`name="tableId"`):** Specifies a specific HubDB table to search. Only returns results from the specified table. Can be used in tandem with the `hubdbQuery` parameter to further filter results.
- **HubDB Query (`name="hubdbQuery"`):** Specify a HubDB query to further filter the search results. Used in tandem with the `tableId` parameter above.
- **Path Prefix (`name="pathPrefix"`):** Specifies a path prefix to filter search results. Will only return results with URL paths that start with the specified parameter. Can be used multiple times.
- **Match Prefix (`name="matchPrefix"`):** Inverts the behavior of the pathPrefix filter when set to 'false'. (Defaults to true)
- **Length (`name="length"`): **Specifies the length of the search results. Can be set to `LONG` or `SHORT`. Setting this parameter to `SHORT` will return a short highlight of the meta description. Setting this parameter to `LONG` will build the snippet based on the html/content of the page. If you are not using the snippet, setting this parameter to `SHORT` will give a slight performance improvement.
- **Analytics (`name="analytics"`):** Specifies whether or not to enable tracking links. Defaults to `false`. When set to true, the content's URL will be replaced with a tracking link.
- **Autocomplete (`name="autocomplete"`)**: Specifies whether or not you are showing autocomplete results. Defaults to `false`code>. If you're not showing autocomplete results, this parameter should be excluded.
- **Popularity Boost (`name="popularityBoost"`)**: Specifies how strongly a result is boosted based on its view count. Defaults to 1.0
- **Maximum Boost (`name="maxBoost"`)**: Specifies the maximum amount a result will be boosted based on its view count. Defaults to 5.0. 
- **Boost Recent (`name="boostRecent"`)**: Specifies a relative time window where scores of documents published outside this time window decay. This can only be used for blog posts. For example, `boostRecent=10d` will boost documents published within the last 10 days. Supported timeunits are `ms` (milliseconds), `s` (seconds), `m` (minutes), `h` (hours), `d` (days).
- **Offset (`name="offset"`):** Used to page through the results. If there are more results than specified by the `limit=` parameter, you will need to use the offset returned in the first request to get the next set of results.
- **Limit (`name="limit"`):** Specifies the number of results to be returned in a single response. Defaults to 10, maximum limit is 100.

A full list of parameters is available on [HubSpot's API documentation](https://developers.hubspot.com/docs/methods/content/search-for-content).

If you found this helpful, buy me a coffee! ❤️

←  Previous Article

[Where to find your HubSpot blog ID](https://www.stephanieogaygarcia.com/hubspot-website-development/where-to-find-your-hubspot-blog-id)

Next Article  →

[Add a "Forward to a Friend" link to HubSpot emails](https://www.stephanieogaygarcia.com/hubspot-website-development/add-a-forward-to-a-friend-link-to-hubspot-emails)

Contact

## Get help from a HubSpot CMS Expert

- Custom HubSpot themes and reusable and easy-to-use HubSpot templates and modules
- Technical support and guidance on the HubSpot CMS

[ Tell me about your project ](https://www.stephanieogaygarcia.com/project-details)

##### Contact

Need help with a HubSpot CMS project? Get in touch!

[Email](mailto:stephanie@stephanieogaygarcia.com) | [Contact](https://www.stephanieogaygarcia.com/contact)

##### About

- [ About ](https://www.stephanieogaygarcia.com/about)
- [ Portfolio ](https://www.stephanieogaygarcia.com/portfolio-work)
- [ LinkedIn ](https://www.linkedin.com/in/stephanieogaygarcia/)
- [ Facebook ](https://www.facebook.com/stephanieogaygarcia)
- [ Instagram ](https://www.instagram.com/stephanieogaygarcia/)

##### Services

- [ HubSpot Website Development ](https://www.stephanieogaygarcia.com/services/hubspot-website-development)
- [ HubSpot CMS Technical Support ](https://www.stephanieogaygarcia.com/services/hubspot-cms-technical-support)
- [ Custom HubSpot CMS Themes ](https://www.stephanieogaygarcia.com/custom-hubspot-cms-hub-themes)
- [ Pricing ](https://www.stephanieogaygarcia.com/services#pricing)

##### Latest Articles

- [How to add an llms.txt page to your HubSpot website](https://www.stephanieogaygarcia.com/hubspot-website-development/add-an-llmstxt-page-to-your-hubspot-website)
- [Switch an existing HubSpot custom module from global to local](https://www.stephanieogaygarcia.com/hubspot-website-development/switch-an-existing-hubspot-custom-module-from-global-to-local)
- [Overriding HubSpot's new forms styling from theme settings](https://www.stephanieogaygarcia.com/hubspot-website-development/overriding-hubspots-new-forms-styling-from-theme-settings)
- [All Articles](https://www.stephanieogaygarcia.com/hubspot-website-development)

---

 Copyright © 2018 - 2026 Stephanie O'Gay Garcia. All Rights Reserved.   
Freelance HubSpot CMS Developer based in Toronto, Canada 🇨🇦   
[Terms of Service](https://www.stephanieogaygarcia.com/terms-of-service) | [Website Terms of Use](https://www.stephanieogaygarcia.com/website-terms-of-use) | [Privacy](https://www.stephanieogaygarcia.com/privacy-policy) | [Cookies](https://www.stephanieogaygarcia.com/cookie-policy) | [LLMs](https://www.stephanieogaygarcia.com/llms.txt)

Scroll to Top

```json
{
  "@context" : "https://schema.org",
  "@id" : "https://www.stephanieogaygarcia.com/#person",
  "@type" : "Person",
  "description" : "Freelance HubSpot CMS Developer specializing in custom HubSpot website development, themes, templates, and bespoke modules for small–mid sized B2B and SaaS companies.",
  "image" : "https://www.stephanieogaygarcia.com/hubfs/Logos/stephanieogaygarcia_logo.svg",
  "jobTitle" : "Freelance HubSpot CMS Developer",
  "knowsAbout" : [ "HubSpot CMS", "HubSpot themes", "HubSpot templates", "HubSpot modules", "HubDB", "Website migrations to HubSpot CMS", "Figma to HubSpot implementation" ],
  "name" : "Stephanie O'Gay Garcia",
  "sameAs" : [ "https://www.linkedin.com/in/stephanieogaygarcia/", "https://www.facebook.com/stephanieogaygarcia", "https://www.instagram.com/stephanieogaygarcia/", "https://ecosystem.hubspot.com/marketplace/solutions/stephanie-ogay-garcia/" ],
  "url" : "https://www.stephanieogaygarcia.com/",
  "worksFor" : {
    "@id" : "https://www.stephanieogaygarcia.com/#organization"
  }
}
```

```json
{
  "@context" : "https://schema.org",
  "@id" : "https://www.stephanieogaygarcia.com/#organization",
  "@type" : "Organization",
  "address" : {
    "@type" : "PostalAddress",
    "addressCountry" : "IE",
    "addressLocality" : "Dublin",
    "postalCode" : "A94"
  },
  "contactPoint" : {
    "@type" : "ContactPoint",
    "areaServed" : "Worldwide",
    "availableLanguage" : [ "en", "es" ],
    "contactType" : "sales",
    "email" : "stephanie@stephanieogaygarcia.com"
  },
  "description" : "Portfolio and business site of freelance HubSpot CMS Developer Stephanie O'Gay Garcia, based in Dublin, Ireland.",
  "logo" : "https://www.stephanieogaygarcia.com/hubfs/Logos/stephanieogaygarcia_logo.svg",
  "name" : "Stephanie O'Gay Garcia",
  "sameAs" : [ "https://www.linkedin.com/in/stephanieogaygarcia/", "https://www.facebook.com/stephanieogaygarcia", "https://www.instagram.com/stephanieogaygarcia/", "https://ecosystem.hubspot.com/marketplace/solutions/stephanie-ogay-garcia/" ],
  "url" : "https://www.stephanieogaygarcia.com/"
}
```

```json
{
  "@context" : "https://schema.org",
  "@id" : "https://www.stephanieogaygarcia.com/#website",
  "@type" : "WebSite",
  "name" : "Stephanie O’Gay Garcia – Freelance HubSpot CMS Developer",
  "publisher" : {
    "@id" : "https://www.stephanieogaygarcia.com/#organization"
  },
  "url" : "https://www.stephanieogaygarcia.com/"
}
```

```json
{
  "@context" : "https://schema.org",
  "@type" : "BlogPosting",
  "author" : {
    "@type" : "Person",
    "name" : "Stephanie O'Gay Garcia",
    "url" : "https://www.stephanieogaygarcia.com/hubspot-website-development/author/stephanie-ogay-garcia"
  },
  "dateModified" : "2025-06-04T15:31:16.556Z",
  "datePublished" : "2019-09-17T15:18:50.000Z",
  "headline" : "Add parameters to your HubSpot Site Search Input module",
  "mainEntityOfPage" : {
    "@id" : "https://www.stephanieogaygarcia.com/hubspot-website-development/add-parameters-to-your-hubspot-site-search-input-module",
    "@type" : "WebPage"
  },
  "publisher" : {
    "@type" : "Organization",
    "logo" : {
      "@type" : "ImageObject",
      "url" : "https://www.stephanieogaygarcia.com/hubfs/Logos/stephanieogaygarcia_logo.svg"
    }
  }
}
```