Add a search box block

Prerequisites

• Create a model with the data you need. See our knowledge base article, Create a new model.
• Create a search item. See our knowledge base article, Add search content and design how your search results appear on pages.
• Open an existing page or create a new one. See our knowledge base article, Add a new page and header.

Procedure

1. Add a Search block to your page:
   1. On your page, select ADD CONTENT, and in the Content dialog box, select the Search box block.
   2. Scroll down and in the Title box, give your search box a meaningful name.
   3. Select SAVE.
2. Configure your Search box settings:
   1. To add a text placeholder in your search box, in the Search input placeholder box, type in the text you want to appear. If you leave this blank, the default text is "Search."
   2. To specify the text of your search box's submit button, in the Button label box, type in the text for your button. If you leave this blank, the default text is "Submit."
   3. To restrict the search to the data in certain models, in the Restrict the search box, start typing the name of the model you want to restrict the search by and select it from the list. Otherwise, to allow a search of all data, leave this blank.
3. Configure your block's general settings:
   1. To configure how wide you want your block, from the Preferred width list, select an option:
      • Automatic - Spans the width of the column on the page depending on what page layout option you have selected.
      • Full-width - Spans the width of all columns but doesn't go beyond the margins on either side of the page unless you select the Edge-to-edge option.
      • Two-third - If you have a three-column page layout, this spans across two of the columns. If you have a two-column page layout set, this spans just beyond the first column, but further blocks won't appear above the advert in the second column, only below it.

        These options are affected by your Page layout options, which you configure in the Page settings dialog. See our knowledge base article, Configure your page settings.

   2. If you don't want a title on your block, clear the Show the title and header bar option.

      Hiding the title and header bar also hides any action buttons you may have included.

   3. To set the Background color of your block, select the color of your choice. The color picker shows a list of preconfigured colors with 100% opacity or fully opaque.

      You can select a pre-configured color nearest to the one you want and then tweak it to what you want using the sliders.

      	1. Color palette	A chart of preconfigured colors.
      	2. Color gradient panel	The color gradient panel shows a mixture of two linear color gradients, your chosen color, and black. The color you choose reflects in the color gradient panel instantly showing where your selected color appears on the panel. You can choose a lighter or darker version of the chosen color from the panel.
      	3. Sample color	Shows the color you've chosen, and that will be applied.
      	4. Hue slider	This slider has a linear gradient of colors. You can choose the main hue you want.
      	5. Opacity slider	Controls the transparency of the color.
      	6. Color mode	This switches between the color value modes: HEX - Sets the color based on a Hexadecimal code value. RGBA - Sets the color based on RBGA (red, green, blue, alpha) decimal values. HSLA - Sets the color based on HSLA (hue, saturation, lightness, alpha) values.

   4. If you want to prevent this block from being displayed on specific devices from the Hide on list, select those conditions where you want to hide this block.

   5. Restrict or allow viewing further by adding custom filters to your block. You can base these filters on anything such as role type, department, or location. Select the Hide or show this block using filters option and set your Conditions.

      If you want to hide this block when the selected data meets every condition you add, add a condition under the Hide when ALL of the following conditions are met (and) section. Otherwise, if you want to hide the block when the selected data meets just one of several conditions, add your conditions under the Hide when ANY of the following conditions are met (or) section.

      1. Under the relevant section, select .
      2. From the Property list, select the model's property.
      3. From the Criteria list, select the condition you want the property value to meet for the block to be hidden.
      4. In the Value box, enter the property's value you want the condition to meet for the block to be hidden.
         • For lookup properties, you can select a lookup option entered when you added the property to the model.
         • For foreign key properties, you can select any values against the default label property of the linked model. However, if there is nothing to select, there might not be any values for the property.
   6. When you are happy with your configuration, select UPDATE.

See more:

• About the search box block

Reference:

• Content dialog box
• Settings: (Search box)