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.
Still can’t find what you are looking for? Try
ChatGPT.
When should I use SW Form?
SW Form is best when the form itself is the focus of the section, such as a contact page, newsletter signup, or gated asset form. It can include optional headings above the form and a styled form box.
If the form needs to sit beside an image, video, testimonial, or longer supporting copy, use SW Pillar Section and set the secondary column to Form.
What is the difference between Module Outer and Module Inner in SW Button?
Module Outer is the full-width band behind the SW Button section. Module Inner is the limited-width box that holds the button row, so its background stays within the page's content width. Use Outer when you want a theme color, custom color, gradient, image, divided background, Aurora, SVG overlay, or Animated treatment to span the section. Use Inner when you want a contained color, gradient, image, video, or Effect around the buttons. If a background looks narrower than expected, check which layer is selected before changing spacing or width settings.
How does the resubmit cooldown work in SW Form and SW Pillar Section?
The resubmit cooldown temporarily prevents a visitor from submitting the same form again. It works only when the HubSpot form submission setting is Show thank you message. If the form redirects to another page after submission, the cooldown cannot remain visible on the original page.
The same rule applies to a form inside SW Pillar Section. Its cooldown is separate from the cooldown for a standalone SW Form, so submitting one does not start the waiting period for the other.
Where should I use SW Blog Listing Hero?
Use SW Blog Listing Hero to feature a post at the top of the main blog listing. Turn on Show on Blog Tag page if the hero should also appear on tag pages. For the Blog All page, use the blog listing template setting Show hero on Blog All page; that option is not in the module. The listing hero does not appear on author archives or individual blog posts.
Why does my legacy blog listing show the wrong posts after I add a listing hero?
This guidance applies to the deprecated SW Blog Cards setup. Check these settings:
Confirm the listing hero is visible only where you expect it, usually on the first listing page.
If the hero displays the newest post, set Post start so the card grid begins with the next post.
Turn on Post start first page only when the hero appears only on page one.
Set HubSpot's Number of posts per listing page to Posts to show plus (Post start − 1).
Preview page one and page two before publishing because settings that look correct on the first page can leave a gap later.
Why does the slider not appear in the legacy SW Blog Cards module?
This troubleshooting applies to the deprecated SW Blog Cards module. Check three requirements:
Turn off Use infinite scroll because it cannot run with the slider.
Turn on Use as slider.
Make sure the module has more posts than the Cards per row (XL) setting, which controls the largest desktop layout.
For a new blog layout, use SW Cards Blog instead of adding another legacy SW Blog Cards module.
What size should I use for a blog featured image in the Smithworks theme?
Start with a 1280 × 640 image for the Smithworks theme. Its 2:1 shape works well in SW Blog Post Hero and listing cards. Keep the subject near the center with extra space around it because responsive layouts and social networks may crop the image differently. HubSpot recommends a 1.91:1 ratio for Facebook and LinkedIn link previews, so 1200 × 630 is also a sound choice when social sharing is the priority. Use a sharp, web-optimized image, add useful alt text, and preview the post on desktop, mobile, and your priority social channel before publishing.
How do I edit the modules in my HubSpot blog post template?
You do not need to create a draft post before editing the blog post template. In HubSpot, open Settings → Content → Blog → Templates. In the Blog Post Template section, choose Actions → Edit to open the template in Design Manager. Edit the module settings there, preview the template, and publish the changes when they are ready. The template is shared by posts in that blog, so check an existing post before publishing a change that could affect every post.
When should I use SW Blog Post Hero, SW Blog Post Body, and SW Blog Related Posts?
These modules work together on single blog post templates. SW Blog Post Hero handles the post hero, featured image, title, and metadata. SW Blog Post Body wraps the article body content.
SW Blog Related Posts is used for a read-next or related-articles area at the bottom of an individual post. It is different from SW Blog Cards, which is used for blog listings or website pages that pull posts.
When should I use SW CTA Popup instead of SW Popup Panel?
SW CTA Popup is the quicker option when you need one simple popup, usually in a bottom corner, with one main variant. It can work for a single offer or a straightforward site-wide promotion.
SW Popup Panel is the more flexible option. Use it when you need multiple variants, different content on different pages, announcement-style panels, more positions, or more detailed trigger behavior.