SW Modules

Frequently Asked Questions - SW Sprocket Rocket Modules

These FAQs explain how Smithworks SW Modules work inside HubSpot, especially for Sprocket Rocket-style themes. Use them to choose the right module, understand common settings, and give AI agents better context before they start guessing.

How many posts should HubSpot send to SW Cards Blog on a listing page?

HubSpot only sends the listing the number of posts in Marketing → Website → Blog → [blog] → Templates → Number of posts per listing page.

The formula is Posts to show + (Post start − 1). If SW Blog Listing Hero shows post 1, Cards Blog should start at post 2 so the same post is not repeated. Too low shows fewer cards than expected; too high skips posts on page 2+.

Infinite scroll is ignored on the native listing page. On website or landing pages it can load more posts (up to 200) and does not use that listing setting.

Can I use a five-up layout on SW Cards Blog?

If you need five cards in a row, add the helper class on an SW Cards module. Blog post cards stay on the module’s Cards per row settings (typically 3 / 3 / 2 / 1). Showcase Middle Card on SW Cards Blog only enlarges the middle card of odd 3-up rows; it is not a five-column layout.

Does SW Cards Blog show on tag, author, or all-posts listing pages?

SW Cards Blog is for the main blog index and for website or landing Insights rows. On /blog/tag/, /blog/tagged/, /blog/author/, and /blog/all it outputs nothing, including when HubSpot does not set the tag object.

Those pages keep the listing template partials: a title such as the blog name plus the tag, and a search/sort list of posts. Website and landing Cards Blog is unchanged.

How do breadcrumbs work on the blog listing and tag pages?

Blog posts already had a trail (Home → blog name → post title). The listing template now uses the same module above the listing hero.

On the blog index the last crumb is the blog name. On a tag page it is the tag name; on an author page, the author name; on all-posts, All Posts. Those extra crumbs are automatic in Trail mode Auto or Blog automatic.

Edit the listing template instance for spacing and labels. BreadcrumbList structured data includes the extra crumb when it is shown.

Where is the title on the blog listing page now?

The listing template no longer prints a separate hardcoded listing H1 above the cards. Set the index title in SW Cards Blog Headings (sample: Strategic Marketing Blog).

On tag, author, and all-posts URLs, Cards Blog is hidden, so the title comes from that view’s listing partial (for example the blog name plus the tag). SW Breadcrumbs sits above the listing hero on all of those listing views.

What happens in SW Cards Blog when there are no blog posts?

When the blog query returns no posts—an empty blog on a website Insights row, or a tag filter with zero matches—SW Cards Blog shows the same empty-state box as the older SW Blog Cards module.

The box sits between the headings and the footer CTA. Card colors and border style the box. On tag, author, and all-posts listing URLs the whole module still hides so those pages can keep their listing lists.

When should I use SW Cards Animated instead of SW Cards?

SW Cards Animated puts icons on a curve. Hover or click opens one card; phones stack with a dock. It is not a replacement for SW Cards grids.

Use SW Cards Blog for blog posts and SW Cards Products for plan/bullet cards. Do not add a five-up helper class here—this module has no grid slider.

How do I open a card in SW Cards Animated on desktop?

Fine pointers use hover; click/tap is the fallback. Closing plays the same motion in reverse. Neighbor icons shift along the path so they stay visible. The heading and footer buttons do not keep a card open.

On phones the first card starts open and Esc does nothing, because stacked view always has one card open.

What happens to SW Cards Animated on phones?

Stacked layout is always on at 767px and below. Optional Stack on MD can force the same layout on tablets. Swipe does not loop back to the first card. Dock icons meet a 44×44 tap target.

Style → Stacked Layout → Margin Top / Margin Bottom (default 25px) sets the gap above the card and above the dock.

How many items can SW Cards Animated show?

One item still expands; there is no neighbor shift and swipe is off. Six is the cap. This is not a blog-post grid—add another module instance if you need a second path.