Listing Page Blocks (category · brand · tag · search)

The four listing pages share the same blocks. When you change a block's setting it applies on every page that block sits on; this page explains which…

Where to find it: Theme Editor → page selector menu → Category Page · Brand Page · Tag Page · Search Results Who it is for: Anyone who wants to tune how product lists are filtered, sorted and paginated, and how the in-list promo area works In short: The four listing pages share the same blocks. When you change a block's setting it applies on every page that block sits on; this page explains which block appears on which pages and what the most recently added settings do.

What is it for?

There are four screens where the visitor sees a product list: category (/category/...), brand (/brand/...), tag (/tag/...) and search results (/search). You design all four separately, but they use one shared block family: the filter panel, the toolbar, the product list and the active filter summary are the same block on all four.

Sayfalar Ve Yapi.en introduces these four page types and what their blocks are for. This page goes one step deeper: it explains each block's settings one by one, together with the pages they apply to.

One block, four pages — where does it change?

This is the most confusing part of the family: the same block can be used on more than one page type, but every page type has its own template. So:

If you change the Product List block's setting in the Category Page template, only category pages are affected.
If you want the same change on the brand, tag and search pages you have to make it separately in each of their templates.

Which page types each block can be used on:

Block	Category	Brand	Tag	Search
Active Filter Summary
Inline Promo
Filter Panel
Toolbar
Product List
Category Breadcrumb				—
Category Intro		—	—	—
Brand Identity Header	—		—	—
Related Tags	—	—		—
Curated Strip	—			—
Search Results Header	—	—	—
No Results State	—	—	—

ℹCategory Breadcrumb does not exist on the search page because a search has no parent category; the visitor arrives there from the search box, not from a navigation path. Even though its name starts with "Category", the block also works on brand and tag pages.

What if a page holds two of the same block? If you place two Product List blocks, only the first one draws the inline promo. Giving the second list its own promo is not possible today.

Active Filter Summary

Shows the filters the visitor selected as chips above the list and lets them remove each one individually. It can be used on all four listing pages and comes ready in the default templates.

Variant: Chips · Bar · Inline

Setting	What it does
Show Filter Group Name	Whether the chip also names the group: "Brand: Nike" instead of just "Nike". Keep it on in stores that use several filter types at once.
Show Result Count	Writes how many products are left next to the chips.
Show Clear All Button	The button that removes every filter in one click.
Clear All Label	The text on that button (default "Tümünü temizle"). Only visible while the button is on.
Max Visible Chips	How many chips to show; the rest are collapsed into "+3 more filters". Set 0 to show them all (default). In catalogs with many filters, 5–8 works well.
Hide Block When No Filter	On by default: if the visitor selected no filter the block is not drawn, so no empty strip appears. Turn it off and the block always takes up space.

Why is this block already in my template? Letting a filtering visitor see what they filtered and undo it in one click keeps them from abandoning the list. Because the block is not drawn at all while there is no filter, it does not change how your page looks today; it only appears once a filter is applied. If you do not want it you can delete it — adding and deleting blocks is allowed on these four pages.

A promotional area that sits between product cards. It can be used on all four listing pages but is not part of any default template: since you write its content, it was not shipped as an empty box. You add it from the library yourself.

Variant: Banner · Card · Full width

Banner and Full width take up a whole row of the grid; Card takes the place of a single product card.

Setting	What it does
After Product Index	Where the promo sits in the list. Set 0 to place it at the very beginning (default 4, maximum 48).
Title · Description · Badge Text	The promo's texts.
Image	The promo image.
Link	The address the promo leads to, and the button text.
Show On Mobile	Turn it off and the promo appears only on desktop and tablet.

The block is drawn inside the list, not where it sits in the template. Wherever you place the block in the template, the promo lands inside the product list at the spot After Product Index names. That is why you see an explained placeholder at the block's own position in the editor — this is not an error, it is there so you can select and configure the block. If the page has no product list at all, the block is drawn in its own position.

What if I leave the title and image empty? The block is not drawn at all on the live site — the visitor never sees an empty box. In the editor it stays as a placeholder so you can fill in its content later.

The panel holding the price, brand and variant filters. It can be used on all four listing pages. A Card variant was added: every filter group sits in its own card.

Variant: Plain · Panel · Bordered · Card

Setting	What it does
Show Product Counts	The (12) figure next to brand and variant options. Turning it off simplifies the panel but the visitor can no longer see how many products each option holds.
Brands Shown Initially	When the brand list is long, how many brands stay visible; the rest hide behind a "Show all (37)" button. Set 0 to list every brand (default). In stores with many brands, 5–10 shortens the panel a lot.
Make Filter Groups Collapsible	Turn it on and each filter group opens and closes when its heading is clicked.
Start With Groups Collapsed	Only visible while collapsing is on. Every group arrives closed and the visitor opens the one they care about. In catalogs with many filter groups this noticeably improves the mobile experience.

The strip holding the product count, sorting and column density. It can be used on all four listing pages. A Stacked variant was added: on narrow screens the elements stack instead of squeezing side by side.

Variant: Split · Compact · Bordered · Stacked

Setting	What it does
Default Sort	The order the list arrives in when the page first opens: Newest (default) · Oldest · Price: low to high · Price: high to low · A-Z · Z-A · Most reviewed. Once the visitor changes the sorting this setting no longer applies.
Max Column Choice	The upper bound of the column buttons offered to the visitor (default 5). Lowering it shows fewer buttons.
Stick To Top While Scrolling	Turn it on and the toolbar sticks to the top of the screen as the page scrolls; on long lists the visitor does not have to scroll back up to change the sorting.
Top Offset (px)	Only visible while stickiness is on. How far below the top of the screen the bar sits (default 80). If you have a fixed menu, set this to your menu's height, otherwise the bar hides underneath it.

Default sort really fetches the list from the server in that order, it does not reorder after the page opens. So the visitor sees the right order on the first paint. There is a cost: if you pick anything other than Newest, caching is bypassed for that page and it may open a little slower.

Product List

Product cards, pagination and the empty-result state. It can be used on all four listing pages.

Variant: Grid · Compact · Editorial

Setting	What it does
Products Per Page	How many products are fetched from the server at once (default 24, minimum 4, maximum 96). Raising it lowers the page count but slows the page down.
Pagination Style	Page numbers (default) or Load more button. With the second one, products are appended to the existing list each time the visitor clicks.
Row Gap (px)	The vertical space between card rows. If you leave it alone the Card Gap value is used; setting it separately gives the list some air in catalogs with long product names.
Empty State Button	The text and address of the button shown when the filters return nothing. Leave the button label empty and no button is drawn. Use it to send the visitor to all products or to the parent category.

The "Editorial" variant is genuinely different now. For a while this variant drew the same card as Grid; it now draws its own editorial card. If you tried it before and said "nothing changed", try it again.

The navigation path from home to the page you are on. It can be used on the category, brand and tag pages. A Pill variant was added: each crumb sits inside a rounded pill.

Variant: Simple · Chevron · Boxed · Pill

Setting	What it does
Separator	The mark between crumbs: Match variant (default — uses the natural separator of the variant you picked) · Chevron · Slash · Dot · Arrow.
Show Current Page	Turn it off and the trail ends with the ancestor crumbs; the name of the page the visitor is on is not repeated. If your page title already sits right below it, turning this off removes the repetition.

Category Intro

The category title, description and subcategory navigation. It can be used only on the category page.

Variant: Simple · Card · Editorial

Setting	What it does
Show Category Icon	If the category record has an icon it is drawn to the left of the title. With no icon defined, nothing appears. You define the icon on the Products → Categories screen.
Description Length	Full (default) or Clamped. Stops long category descriptions from pushing the list down.
Show Read More Link	Adds a link below the clamped description that expands and collapses it, so the visitor can read the whole text if they want.
Max Child Categories	How many links the subcategory navigation shows. Set 0 to show them all (default). In parent categories with many children, 8–12 stays balanced.

Brand Identity Header

The brand logo, description and counters. It can be used only on the brand page.

Variant: Compact row · Cover hero · Narrative and facts

Setting	What it does
Eyebrow	Only in the Narrative and facts variant, the small line above the title (default "Marka"). You could write something like "Official reseller" or "Brand world".
Clamped Line Count	How many lines the description is cut after (default 2, maximum 8). Only visible while the description length is Short.
Read More Label	The text of the link that expands the description (default "Devamını oku").

ℹIf the brand description is empty none of these three settings has a visible effect. You enter the description on the brand record on the Products → Brands screen.

The internal link network between tags. It can be used only on the tag page.

Variant: Chip row · Tag cloud · Card list

Setting	What it does
Sort By	Product count (default — the richest tags first) or Name (alphabetical). Alphabetical order makes it easier for the visitor to scan for what they want.
Hide Empty Tags	Tags with zero products are not listed. Stops the visitor from clicking through to an empty page.
Card Columns	Only in the Card list variant; how many columns the cards are laid out in (default 3, maximum 4).

Curated Strip

The "bestsellers" / "new arrivals" strip above the product grid. It can be used on the brand and tag pages.

Variant: Horizontal carousel · Ranked list · Dual section

Setting	What it does
Card Type	The shape of the product card in the strip: Minimal (default) · Classic · Compact · Overlay. Pick a different type to separate the strip visually from the main list below.
Card Width	Only in the Horizontal carousel variant: Narrow · Regular (default) · Wide. Narrow fits more products on the same screen.
Items In Dual View	Only in the Dual section variant: how many products each strip holds (default 2, maximum 6).

Search Results Header

The query, result count and spelling correction. It can be used only on the search page.

Variant: Summary line · Prominent heading · With suggestion chips

Setting	What it does
Show Search Box	Places a search box inside the results page; the visitor can change their query without going back to the top menu. Worth turning on in stores where search is heavily used.
Idle Screen Title	The heading shown when the visitor lands on the search page without searching for anything (default "Ne aramak istersiniz?").
Idle Screen Description	The description text on that same screen.

Do not forget the idle screen. The search page has three states: nothing searched yet, results found, and no results. These two settings only concern the first one — and it is the screen merchants skip most often.

No Results State

The guidance area shown when a search returns nothing. It can be used only on the search page.

Variant: Plain · Guided · With recommendations

Setting	What it does
Suggestions Section Title	The heading above the recommended products (default "Çok satanlar").
Popular Categories Title	The heading above the category links (default "Kategorilere göz atın").
Support Link Label	The text of the contact link (default "Aradığınızı bulamadınız mı? Bize yazın"). Only visible while the contact link is on.

This block rescues sales. A visitor who finds nothing usually leaves the site. Keeping the product recommendations and popular categories on gives that visitor a direction instead of an exit.

"The block I deleted keeps coming back"

Adding and deleting blocks is allowed on these four pages. But if the block you deleted is one of the template's built-in parts (the Toolbar or the Active Filter Summary, for example), it comes back the next time you open the editor.

The reason: if your template is old, missing blocks have to be completed automatically — otherwise a newly added block would never reach any store. That completion cannot yet tell "the merchant deleted this on purpose" apart from "this template is old".

What to do: instead of deleting the block, turn it off with its visibility switch. A block that is switched off is not switched back on, and the visitor does not see it either. The result is the same as what you wanted, and it lasts.

"The number in the panel differs from the one on my site"

When a new setting is added, its box stays empty in older templates that never touched that setting. The panel shows the smallest allowed value in an empty number box — not the setting's real value.

The most visible example is Product List → Products Per Page: the panel says 4, but your site draws 24 products per page. The site behaves correctly; it is the panel's display that misleads.

What to do: type the value in once and save. From that moment on the panel and your site show the same number. If you do not want to change the value, simply type the value you already have (24, for example) and save.

Frequently asked

I changed a setting on the category page and my brand page did not change. Why? Every page type has its own template. If you want the same setting on the brand, tag and search pages you have to edit each of their templates separately. The table above shows which block appears on which pages.

I added the Inline Promo block but I cannot see it on my site. Three possibilities: (1) the title, description, badge and image are all empty — in that case the block is not drawn on the live site; (2) the After Product Index value is larger than the number of products on that page; (3) Show On Mobile is off and you are looking from a phone.

The counts next to my filters look wrong. While Show Product Counts is on, the figures are calculated for the current filter combination; it is normal for them to change when another filter is selected.

Will raising products per page affect my SEO? The page count drops and each page gets heavier. Very high values (80–96) lengthen the page load time, which can hurt mobile ranking. Between 24 and 48 is balanced for most catalogs.

Can I delete the Active Filter Summary block? Yes, deleting blocks is allowed on these four pages — but turning it off is recommended over deleting; see the "The block I deleted keeps coming back" section above.

Listing Page Blocks (category · brand · tag · search)

On this page