Skip to content

Look

Card templates

On this page

A card template sets how a result looks in your shop's search window: which details the card shows, in which order and in which style.

The card templates of a site, with the status, content type and priority of each template

Each template is for one content type, such as products. You design it in a drag-and-drop builder, with real products from your shop in the preview. A template reaches your shop only once you publish it.

To open the templates of a site:

  1. Go to Sites > Northline Outdoor > Search & relevance.
  2. Click Card templates at the top right.

The owner and members with the Manager or Editor role can create and change templates. See Account, security and team.

The template list

The list shows each template of a site with these columns:

Column Content
Name The template's name. The default template of its content type carries the Default badge. Clicking the name opens the builder.
Content type Which results the template is for: Products, Posts, Pages or Categories.
Status Draft or Published. Only published templates appear in your shop.
Priority For a template with display rules, its priority and the number of rules. See Display rules.
Created by The member who created the template.
Updated When the template was last changed.

Above the list you can search by name and filter by Content type and Status. The menu at the end of each row holds Open builder, Settings, Publish or Unpublish, Duplicate, Export and Delete.

A site can have up to 50 card templates.

Create a template

  1. Click New template.
  2. Enter a Name, for example "Outdoor product card".
  3. Choose the Content type, here Products.
  4. Click New template.

The new template is a draft. It starts with a card that shows the product image and the title and links to the product page. Click its name to open it in the builder.

You set the content type when you create a template. It cannot be changed later.

The builder

The builder has three areas:

  • on the left, the Components tab, with the elements you can add, and the Structure tab, with the card's layout as a tree;
  • in the middle, the card, filled with a real product from your shop;
  • on the right, the settings of the element you selected.

The card builder, with the components on the left, a Northline Outdoor product card in the middle and the price settings on the right

Click an element on the card to edit it. A click on the empty space around the card clears the selection and shows the final look.

Add and arrange elements

  • Drag a component onto the card, to the place where it should appear. While you drag, thin lines mark the possible positions.
  • Or click a component: it is added to the selected container, or to the card itself.
  • To move an element, drag it to a new place on the card or in the Structure tab. The arrows at the top of the settings move it up or down by one position.
  • Right-clicking an element opens a menu with an entry to edit it, such as Edit Price, and Duplicate, Copy, Paste and Delete. The card itself cannot be deleted.

A Container groups several elements, such as brand, title and price under the image. A new container stacks its content, with 8 pixels between items.

The elements

Element What it shows Main settings
Card The whole card. It is always there. Link field: where a click on the card leads, usually url.
Container A group of elements. Style and layout only.
Image An image. Content source: a Document field such as image, or a fixed Image URL.
Text A text, such as the title, brand or a short description. Content source with a Field or a fixed Text, Prefix, Suffix and HTML tag.
Badge A small label, added with the text "SALE". As for text.
Button A button. Content source with a Text or a Field, and Link field.
Icon A symbol from a fixed set. Icon.
Rating Stars for a rating from 0 to 5. Field, usually rating.
Divider A line between elements. Style only.
HTML Your own markup. HTML code. Placeholders such as {{title}} are replaced with the product's values. Scripts are removed on publishing.
Price The price, with sale and range prices. See The price.

You pick a field from the list of fields your products have. You can also type a field name that the sample products do not have yet.

The price

The Price element shows the right price for each product:

  • When the Min price field and the Max price field differ, as for a jacket with variants, it shows the lowest price with the Range prefix before it, for example "from £129.90".
  • When the product has a value in the Sale price field, it shows the regular price struck through and the sale price beside it.
  • Otherwise it shows the price from the Price field.

The fields are preset to price, regular_price, sale_price, price_min and price_max. If your products' price fields are named differently, pick them here. For the display you set:

  • Currency: The shop's, the currency your plugin reports, or Own symbol with a Currency symbol of your choice. Until the plugin has reported a currency, the card shows the symbol below.
  • Currency position: before or after the amount, each with or without a space.
  • Decimals (0 to 4), Decimal separator and Thousand separator. A new price is set for German formatting, with the symbol after the amount and a comma for decimals. For a UK shop, choose Before amount, "." and ",".
  • Range prefix: left empty, it is said in the template's language, "from" in English and "ab" in German. Enter your own words to replace it.
  • Note (below the price): a new price starts with "inkl. MwSt. zzgl. Versandkosten", German for "incl. VAT, plus shipping". Change it for an English shop, or leave the field empty to show no note.

Under Price part styles you style the four parts of the price one by one: Current, Regular, Prefix and Suffix. The regular price is struck through from the start.

Styling

Below an element's settings come its styles, grouped into sections: Typography, Layout, Spacing, Size, Background, Border, Effects and Position. Each element shows only the sections that suit it. Show more reveals further settings of a section.

  • The Desktop, Tablet and Mobile icons in the toolbar choose the screen size you are styling. A value you leave empty for a smaller size is taken from the larger one.
  • Hover styles the state in which a visitor points at the element, such as a darker button.

Show only when

Under Show only when you set an element to appear only for certain products. Click Add a rule and choose a Field, a condition and, where needed, a Value. When an element has several rules, all of them must match.

An element with rules carries a crossed-out eye in the Structure tab. When a rule does not match the product in the preview, the element appears faded.

The conditions are the same as for a template's display rules.

Custom CSS

Under Custom CSS & classes you give an element Custom CSS classes (without the dot) and Custom CSS. Use selector to target the element itself, for example selector:hover { … }. The card also has Template CSS (applies to the whole card).

Preview with sample data

The card in the middle shows one of up to five real products of your site. On a wide screen you can pick another product in the toolbar.

Sample data opens the preview's product as JSON. Change a value there, such as a sale price, and click Apply to see how the card looks with it. The change is for the preview only. If your site has no content of this type yet, the preview shows a general example.

Save and publish

  • Save design saves your changes. The template's status stays as it is.
  • Publish puts the saved design into your shop. While changes are unsaved, the button is disabled.

When you change a published template, your shop keeps showing the design you last published. After saving, click Publish again for the change to appear in your shop.

Leaving the builder with unsaved changes asks first. Back to templates returns to the list.

Example: a product card with brand and sale price

Northline Outdoor wants to show the brand above each product title, sale prices struck through beside the regular price, and a "Sale" label on reduced products only. The brand arrives in the field brand.

  1. Create an "Outdoor product card" template for Products and open it in the builder.
  2. On the Components tab, click Container. Drag the title into the new container.
  3. Drag a Text into the container, above the title. Choose brand as its Field and set a small, grey font under Typography.
  4. Drag a Price into the container, below the title. The price fields already fit. Choose The shop's (GBP) under Currency, Before amount under Currency position, "." as Decimal separator and "," as Thousand separator, and change the Note (below the price).
  5. Drag a Badge onto the card, above the image. Change its Text to "Sale". Under Show only when, add a rule: field sale_price, condition exists.
  6. Pick a reduced product in the toolbar, such as a rain jacket, to check the label and the struck-through price.
  7. Click Save design, then Publish.
  8. In the list, open the template's Settings, tick Make default and click Save changes.

Template settings

Settings in a row's menu opens the settings that are not part of the design:

Setting Meaning
Name The name in the list. Visitors do not see it.
Make default Makes the template the default for its content type. Each content type has at most one default template: when you choose another, the previous one loses that role.
Language Only on a site with languages: Every language, or the one language the template is for. Make a template per language for texts such as the button: a page shows the template for its language, or else one for every language.
Priority A number from 0. Templates with display rules are checked in ascending priority.
Display rules Conditions under which the template is used instead of the default.

These settings apply without publishing again.

Display rules

Display rules give certain products a card of their own. A second template, "Sold out", can show products that are out of stock faded and without a button, with the rule in_stock is false.

Click Add a rule and enter the Field, a condition and, where needed, a Value. A template can have up to 10 rules, and a result must meet all of them.

Condition Matches when the field
exists has a value
does not exist is empty or missing
equals / does not equal matches the value or not, compared as text
greater than / less than is greater or less than the value, as a number
contains contains the value
is true / is false is true or false, such as in_stock

Leave the display rules empty on the default template only.

How a template reaches your shop

For each result, the search window picks one of the published templates of its content type:

  1. It checks the templates with display rules first, in ascending priority. The first whose rules all match is used.
  2. If none matches, it uses the default template.
  3. If no template fits the content type, it shows its own card.

Templates with the Draft status never appear in your shop. Unpublish turns a published template back into a draft and so takes it out of your shop.

In the WordPress plugin, choose the template designed in the Searcio dashboard under Card source in the block or the Elementor widget. See Add the search to your site in the WordPress plugin guide. Your own integration loads the published templates through the REST API.

Duplicate, export and import

  • Duplicate creates a copy as a draft, with "(copy)" after the name. The copy is never the default. This lets you try a new design without changing the published one.
  • Export downloads the template as a JSON file, with its name, content type, display rules, design and template CSS.
  • Import above the list creates a new template from an exported file. Paste the file's contents into the field and click Import. The imported template is a draft and never the default.

Export and import let you move a template to another site of your account.

Delete a template

  1. Choose Delete in the row's menu.
  2. Confirm with Delete.

The search window stops receiving the template at once. A deleted template cannot be restored in the dashboard.