Subcategories

The Subcategories widget automatically displays a grid or list of the direct children of the current category being viewed. It inherits many layout and styling options from the Articles widget, allowing you to control the number of columns, visibility of elements like images and titles, and customize their appearance.

Note: This widget automatically displays the direct subcategories of the current category being viewed. The subcategories themselves are managed in the PrestaShop back office under Catalog > Categories.

Content tab

Configure the source, layout, and content elements for the subcategories display.

Subcategories widget Content tab - Source & Query

Query

Order By

Sets the sorting criteria for the subcategories: Default, Position, Title, Date (ID), or Random.

Order Direction

Chooses the sorting direction: Ascending or Descending; this setting is not applicable for 'Random' order.

Offset

Specifies the number of subcategories to skip from the beginning of the list (e.g., enter '2' to skip the first two subcategories).

Limit

Sets the maximum number of subcategories to display; leave empty or enter '0' for no limit.

Subcategories widget Content tab - Heading

Heading

Heading

Enter an optional main title to display above the subcategories grid.

Display (Heading)

Adjusts the predefined visual size for the main heading (Small, Medium, Large, XL, or XXL).

HTML Tag (Heading)

Selects the appropriate HTML tag (H1-H6, Div, Span, or Paragraph) for the main heading.

Subcategories widget Content tab - Layout & Display

Layout & Display

Layout

Chooses the arrangement of subcategories: Grid, Masonry, or Inline (horizontal scroll).

Columns

Sets the number of columns for Grid or Masonry layouts on different devices.

Column Width (Inline Layout)

Sets the width of individual columns when 'Layout' is 'Inline'.

Scroll Snap (Inline Layout)

Enables subcategories to snap to the start of the viewport when scrolling horizontally in 'Inline' layout.

Subcategories widget Content tab - Image

Image

Image

Toggles the visibility of the subcategory's image.

Image Size

Chooses the predefined image size for subcategory images.

Image Position

Sets the position of the image relative to the text content (Top, Left, Right, or Bottom).

Subcategories widget Content tab - Title

Title (Per Subcategory)

Title

Toggles the visibility of the individual subcategory's title.

Title Display

Adjusts the predefined visual size for individual subcategory titles.

Title HTML Tag

Selects the appropriate HTML tag for individual subcategory titles.

Subtitle

Chooses what to display as a subtitle below the title: None, Meta Title, Meta Description, Read Time, or Custom text.

Before (Subtitle - Read Time)

Enter text to display immediately before the 'Read Time' subtitle; this setting is visible if 'Subtitle' is 'Read Time'.

After (Subtitle - Read Time)

Enter text to display immediately after the 'Read Time' subtitle; this setting is visible if 'Subtitle' is 'Read Time'.

Custom Subtitle Text

Enter your custom text if 'Subtitle' is set to 'Custom'.

Subcategories widget Content tab - Excerpt

Excerpt

Excerpt

Toggles the visibility of a short excerpt or description for each subcategory.

Excerpt Length

Sets the maximum number of characters for the excerpt; this setting is visible if 'Excerpt' is enabled.

Subcategories widget Content tab - Call to Action

Call to Action

Call to Action

Toggles the visibility of a 'View products' link for each subcategory.

Text

Customizes the text for the call to action link (e.g., "View Products"); this setting is visible when 'Call to Action' is enabled.

Apply Link On

Determines whether the link applies only to the default element (e.g., title, button) or to the entire subcategory box.

Subcategories widget Content tab - No Results

No Results

Empty Message

Enter a message to display when no subcategories are found matching the query criteria.

Style tab

Customize the appearance of the main heading, layout, subcategory boxes, images, and content.

Subcategories widget Style tab - Heading

Styles below apply only if a Heading is entered in the Content tab.

Heading

Spacing

Adjusts the space below the main heading.

Alignment

Aligns the main heading horizontally.

Text Color

Sets the color of the main heading text.

Typography

Controls the font family, size, weight, and other typographic settings for the main heading.

Text Stroke

Applies an outline effect to the main heading text.

Text Shadow

Applies a shadow effect to the main heading text.

Subcategories widget Style tab - Layout

Layout

Columns Gap

Adjusts the horizontal spacing between subcategory columns.

Rows Gap

Adjusts the vertical spacing between subcategory rows.

Alignment

Aligns the entire subcategories block (container of all subcategories).

Vertical Alignment

Aligns the content (image and text) vertically within each subcategory box when 'Image Position' is 'Left' or 'Right'.

Subcategories widget Style tab - Box

Subcategory Box

Box Shadow (Normal & Hover)

Applies a shadow effect to individual subcategory boxes for both their normal and hover states.

Background Color (Normal & Hover)

Sets the background color for subcategory boxes for both their normal and hover states.

Border Color (Normal & Hover)

Sets the border color for subcategory boxes for both their normal and hover states.

Border Width

Controls the thickness of the border around each subcategory box.

Border Radius

Adjusts the roundness of the corners for each subcategory box.

Padding (Box)

Defines the inner padding for the entire subcategory box (around both image and text content).

Content Padding

Defines the inner padding specifically for the text content area within each subcategory box.

Subcategories widget Style tab - Image

Styles below apply only if 'Image' is enabled in the Content tab.

Image

Spacing

Adjusts the space between the image and the text content within a subcategory box.

Aspect Ratio

Sets a fixed aspect ratio for the images.

Object Fit

Controls how images resize to fit their container when an aspect ratio is set (Fill, Cover, Contain, or Scale Down).

Width

Sets the width of the image container within the subcategory box.

Border Radius

Adjusts the roundness of the corners for the images.

CSS Filters (Normal & Hover)

Applies visual effects like blur or brightness to images for both their normal and hover states.

Hover Animation

Applies an animation effect to the image when the mouse hovers over it.

Transition Duration

Sets the time it takes for image hover effects to transition smoothly.

Subcategories widget Style tab - Content Elements

Title (Subcategory)

Color

Sets the text color for individual subcategory titles.

Typography

Controls the font family, size, weight, and other typographic settings for individual subcategory titles.

Spacing

Adjusts the space below individual subcategory titles.

Subtitle

Color

Sets the text color for the subcategory subtitles.

Typography

Controls the font family, size, weight, and other typographic settings for subcategory subtitles.

Spacing

Adjusts the space below subcategory subtitles.

Excerpt

Color

Sets the text color for subcategory excerpts.

Typography

Controls the font family, size, weight, and other typographic settings for subcategory excerpts.

Spacing

Adjusts the space below subcategory excerpts.

Call to Action

Color

Sets the text color for the 'View products' link.

Typography

Controls the font family, size, weight, and other typographic settings for the call to action link.

Subcategories widget Style tab - No Results

No Results

Styles below apply only if 'Empty Message' is entered in the Content tab.

Color

Sets the text color for the 'No Results' message.

Typography

Controls the font family, size, weight, and other typographic settings for the 'No Results' message.

Advanced tab

Access advanced layout, motion, and custom CSS options.

Advanced Tab Layout
Margin

Define the external space around the widget for separation from adjacent elements.

Padding

Set the internal spacing within the widget to control the arrangement of its content.

Width

Specify the widget's width behavior: Full Width, Inline, Custom, or Calculate.

Full width
  • Vertical align: Set the vertical alignment to start, center, end, or stretch.
  • Size: Define the size as none, grow, or custom to determine widget dimensions.
Inline
  • Vertical align: Set the vertical alignment to start, center, end, or stretch.
  • Size: Define the size as none, grow, or custom to determine widget dimensions.
Custom
  • Custom Width: Set the width in pixels, percentage, or viewport width (vw).
  • Vertical align: Set the vertical alignment to start, center, end, or stretch.
  • Size: Define the size as none, grow, or custom to determine widget dimensions.
Calculate
  • Calc: Use calculations like 100% - 20px to dynamically define the width.
  • Min Width: Set a minimum width in pixels, percentage, or viewport width (vw).
  • Vertical align: Set the vertical alignment to start, center, end, or stretch.
  • Size: Define the size as none, grow, or custom to determine widget dimensions.
Order

Control the widget's order using start, end, or custom values.

Position

Choose default, absolute or fixed positioning for the widget.

Absolute
  • Horizontal Orientation: Determines the element's horizontal alignment within its nearest positioned ancestor.
  • Offset: Specifies the distance between the element and the left or right edge of its containing block.
  • Vertical Orientation: Sets the element's vertical alignment within its nearest positioned ancestor.
  • Offset: Defines the space between the element and the top or bottom edge of its containing block.
Fixed
  • Horizontal Orientation: Controls the element's horizontal alignment relative to the browser window.
  • Offset: Adjusts the distance between the element and the left or right edge of the viewport.
  • Vertical Orientation: Manages the element's vertical alignment relative to the browser window.
  • Offset: Defines the space between the element and the top or bottom edge of the viewport.
Z-index

Set the stacking order of the widget relative to other elements.

CSS ID

Assign a unique CSS ID for custom styling or interaction.

CSS Classes

Add custom CSS classes for targeted styling via external stylesheets.

Element Cache

Improves loading times by storing a static version of this element.

Advanced Tab Motion Effects
Scrolling Effects

Enhance elements with various dynamic effects triggered by the user's scrolling behavior.

  • Vertical Scroll: Configure the scroll direction, speed, and viewport range for vertical scrolling effects.
  • Horizontal Scroll: Set the scroll direction, speed, and viewport range for horizontal scrolling effects.
  • Transparency: Adjust the transparency based on the direction, level, and viewport range.
  • Blur: Apply a blur effect with customizable direction, level, and viewport range.
  • Rotate: Rotate the element using direction, speed, and viewport settings.
  • Scale: Scale the element with direction, speed, and viewport controls.
  • Apply Effects on: Choose whether to apply scrolling effects on desktop, tablet, or mobile devices.
  • Effects Relative to: Define whether the effects are relative to the default container, the viewport, or the entire page.
Mouse Effects

Enable mouse based effects for added interactivity.

  • Mouse Track: Adjust the direction and speed of the effect as the user moves the mouse across the page.
  • 3D Tilt: Enable 3D tilt effects with controllable direction and speed for a more immersive experience.
Sticky Effects

Fix elements at the top or bottom of the viewport as the user scrolls for persistent visibility.

  • Sticky on: Apply sticky effects on desktop, tablet, or mobile devices.
  • Offset: Set the offset in pixels to trigger the sticky effect after scrolling.
  • Dynamic Offset: Use a CSS selector to dynamically set the offset based on other elements on the page.
  • Effects Offset: Configure the pixel offset to control when additional effects apply.
  • Stay in Column: Choose whether the sticky element remains within its column during scrolling (yes or no).
  • Hide on Scroll: Set the offset and transition duration for hiding the sticky element when scrolling down.
Entrance Animation

Apply predefined animations to elements when they appear on screen.

  • Fading: Elements gradually fade in or out of view.
  • Revealing: Create smooth reveal effects as elements come into view.
  • Sliding & Revealing: Combine sliding motion with reveal effects.
  • Scaling & Revealing: Adjust the size of elements as they are revealed.
  • Zooming: Apply zoom in or out effects during element appearance.
  • Bouncing: Elements enter with a bouncing motion for attention-grabbing effects.
  • Sliding: Elements slide into view from different directions.
  • Rotating: Apply rotation effects as elements enter or leave the viewport.
  • Attention Seekers: Highlight elements with exaggerated, noticeable animations.
  • Specials: Unique animations for elements that require special effects.
Advanced Tab Transform
Opacity

Adjust the transparency level of the element to create fade effects during normal or hover states.

Rotate

Rotate the element along the X, Y, or Z axes for dynamic visual effects. Use deg (degrees) values or apply 3D rotation.

Offset

Shift the position of the element horizontally (X-axis) or vertically (Y-axis) to control its exact placement within the layout.

Scale

Resize the element, with the option to keep proportions (yes or no) and adjust the scale factor to enlarge or shrink the element.

Skew

Skew the element along the X and Y axes to tilt its appearance.

Flip Horizontal/Vertical

Flip the element horizontally or vertically by selecting the anchor points (X: left, center, right; Y: top, center, bottom) for precise control over the flip transformation.

Trigger by (On hover)

Choose whether the hover transformation is triggered by interaction with the widget, column, or section.

Transition Duration (On hover)

Set the time duration in milliseconds that the hover transition effect takes to complete.

Transition Delay (On hover)

Specify a delay in milliseconds before the hover transition effect begins.

Advanced Tab Background
Background Type

Select the background type: None, Classic, or Gradient.

Classic
Color
Set a solid background color to provide a consistent base for your design.
Image
Upload an image to use as the background. Additional settings include:
  • Loading: Choose whether to load the background image lazily or immediately.
  • Position: Define the image's position within the background (e.g., center, top-left).
  • Attachment: Set the background image to scroll with the page or remain fixed.
  • Repeat: Determine if the image repeats or stays single across the background area.
  • Size: Control the size of the background image, such as cover, contain, or custom dimensions.
Backdrop Filters
Apply visual filters to the background, such as blur, brightness, or contrast, enhancing its appearance.
Transition Duration (On hover)
Set the time duration in milliseconds that the hover transition effect takes to complete.
Gradient
Color
Select the primary color for the gradient background.
Location
Define the starting position of the primary color in the gradient effect.
Second Color
Select the secondary color to blend into the gradient.
Location
Set the starting point of the secondary color within the gradient.
Angle
Adjust the angle at which the gradient flows (e.g., horizontal, vertical, diagonal).
Backdrop Filters
Apply visual filters to the gradient background for added depth and effects.
Transition Duration (On hover)
Set the time duration in milliseconds that the hover transition effect takes to complete.

Advanced Tab Border
Border Type

Define the border style of the element.

Border Width

Set the thickness of the element's border.

Border Color

Define the color of the element's border.

Border Radius

Adjust the corner roundness of the element.

Box Shadow

Apply shadow effects to add depth to the element.

Advanced Tab Visibility
Responsive Visibility

Control the display of elements across different devices by selectively hiding them on desktop, tablet, or mobile.

Scheduled Visibility

Set the section's visibility based on specific schedules.

Customer Group Visibility

Control section visibility based on customer groups.

Advanced Tab Custom CSS
Custom CSS

Apply custom CSS to style the widget beyond the default settings.

Note: This requires CSS knowledge—use carefully, as incorrect syntax can impact other areas of the site.

/* For main element */
selector { 
  color: red; 
}

/* For child element */
selector .child-element { 
  margin: 10px; 
}

/* Or use any custom selector */
.my-class { 
  text-align: center; 
}

If you want to learn the basics of CSS, W3Schools is a great resource for that.

© WebshopWorks - Professional PrestaShop Addons