Skip to content

Sparks for WooCommerce - Settings Reference

Sparks for WooCommerce adds eight conversion-boosting features to WooCommerce stores: product wishlists, product comparisons, variation swatches, quick view, advanced product reviews, multi-announcement bars, custom thank you pages, and a product tabs manager. You can find the main settings dashboard under WooCommerce > Sparks in the WordPress admin (or Settings > Sparks if WooCommerce is not active as a top-level menu). If the active theme is neve you can find the main settings dashboard under Neve > Sparks.

Dashboard

The dashboard is the landing page you see when you open the Sparks settings. It displays a grid of module cards, each representing one of the eight features. Every card has an Activate/Deactivate toggle and, for some modules, a Configure button that opens a dedicated settings page within the dashboard.

All module cards are disabled and shown at reduced opacity until you activate a valid license. You must enter a license key before you can turn on any feature.

License

License Key

Enter the license key from your ThemeIsle purchase history. When activated, a verified badge and expiration date appear. When the license is valid, all module cards become interactive and you can activate individual features. If the license expires or is deactivated, all modules become unavailable on the front end.

This panel does not appear if you installed the plugin through the WooCommerce.com marketplace, since licensing is handled by WooCommerce.com in that case.

Product Wishlist

When you activate this module, customers can save products to a personal wishlist and return to buy them later. The module card shows an Activate/Deactivate toggle. Click Configure to open the full settings page described under the Product Wishlist tab below.

Products Comparison

When you activate this module, customers can select products and compare their attributes side by side in a table. Click Configure to open the full settings page described under the Products Comparison tab below.

Variation Swatches

When you activate this module, product variation dropdowns are replaced with visual swatches (color, image, or label). The module card includes one inline setting:

Product Quick View

When you activate this module, a quick view button appears on product cards in the shop, letting customers preview product details in a modal without leaving the page. The module card includes one inline setting:

Button Position

Controls where the quick view button appears on product cards in your shop and category pages. The choices are:

  • None disables the button on archive pages entirely. Use this if you only want quick view triggered by a custom shortcode or theme integration.
  • Center of product image on hover overlays the button in the middle of the product image when the customer hovers over it.
  • Bottom of product image on hover places the button along the bottom edge of the product image on hover.
  • Bottom of the product card places the button below the product image and title area, visible without hovering.

Advanced Product Reviews

When you activate this module, the standard WooCommerce review form gains additional capabilities such as image uploads, review titles, anonymized names, and voting. This module does not have a Configure button on the dashboard. Its settings appear under WooCommerce > Settings > Products, described in the Advanced Product Reviews section below.

Product Tabs Manager

When you activate this module, you gain control over the tabs shown on WooCommerce product pages. You can reorder, rename, hide, and add custom tabs globally or per product. This module does not have settings on the dashboard itself. Configuration happens through the Product Tabs custom post type and the per-product tab editor, both described in the Product Tabs Manager section below.

Multi-Announcement Bars

When you activate this module, you can create dynamic announcement bars that appear on your store pages based on cart contents, user status, or time-based rules. This module does not have settings on the dashboard itself. You create and configure individual announcement bars as a custom post type, described in the Multi-Announcement Bars section below.

Custom Thank You Pages

When you activate this module, you can redirect customers to different thank you pages after checkout based on what they purchased, how they paid, or which shipping method they chose. This module does not have settings on the dashboard itself. Configuration happens through the Thank You Pages custom post type, described in the Custom Thank You Pages section below.

Product Wishlist

This tab appears when you click Configure on the Product Wishlist card on the dashboard.

General Settings

Button Position (Product Loop)

Controls where the wishlist button appears on product cards in your shop and category archive pages. The choices are:

  • None hides the button on archive pages. Use this if you only want the wishlist button on single product pages.
  • Top places the button at the top of the product card, overlaying the product image.
  • Bottom places the button at the bottom of the product card, overlaying the product image.
  • In Product Body places the button inline within the product card content area, below the image.

Button Position (Product Page)

Controls where the wishlist button appears on the single product detail page. The choices are:

  • None hides the button on product pages. You can still display the button using the [sparks_wl_button] shortcode placed manually in your templates or page builder.
  • After Add to cart places the button directly after the Add to Cart button, which is the most common and intuitive position.
  • After the summary places the button below the full product summary section, further down the page.

Button Style

Text & Border

Sets the default text and border color of the wishlist button. Change this to match your theme's color scheme.

Hover Text & Border

Sets the text and border color when a customer hovers over the wishlist button.

Background

Sets the default background color of the wishlist button.

Hover Background

Sets the background color when a customer hovers over the wishlist button.

Active Background

Sets the background color when the product is already in the customer's wishlist. The default red provides a clear visual indicator that the item has been saved.

Active Text & Border

Sets the text and border color when the product is already in the customer's wishlist.

Wishlist Icon Options

Icon

Selects which icon appears on the wishlist button. Four built-in heart icon styles are available, plus a custom SVG option. Choose the style that best fits your theme's design language. When you select the custom SVG option, a text area appears where you can paste your own SVG markup.

Custom SVG content

Paste a valid <svg> element to use as the wishlist icon. Only appears when the custom SVG icon option is selected above. Recommended SVG dimensions are width 16 and height 16. Fill attributes on <path> elements inside the SVG are ignored by the plugin so that the button color settings control the icon color.

Products Comparison

This tab appears when you click Configure on the Products Comparison card on the dashboard.

General Settings

Choose Comparison Product Page

Selects which WordPress page displays the full comparison table. When a customer clicks "Compare" after selecting products, they are taken to this page. You need to create a page and select it here for the comparison feature to work; without a designated page, customers have no destination for viewing their comparison.

Button Position (Product Loop)

Controls where the compare checkbox appears on product cards in your shop and category archive pages. The choices are:

  • Top places the checkbox at the top of the product card, overlaying the product image.
  • Bottom places the checkbox at the bottom of the product card, overlaying the product image.
  • In Product Body places the checkbox inline within the product card content area, below the image.

Number of Products Limit

Sets the maximum number of products a customer can add to a single comparison. Accepts a value between 2 and 4. A lower limit keeps the table readable on smaller screens. A higher limit gives customers more flexibility but may produce a wide table that requires horizontal scrolling.

When enabled, the comparison table suggests related products that the customer might want to add to their comparison. This encourages further browsing and can help customers discover alternatives they had not considered.

Enable "Hide identical values" Checkbox

When enabled, the comparison table displays a checkbox that lets customers hide rows where all compared products have the same value. This helps customers focus on the differences that matter rather than scanning through identical specifications.

Table Colors

Table rows background

Sets the background color for rows in the comparison table. Adjust this to match or complement your theme.

Header text

Sets the text color for the header row of the comparison table.

Table text

Sets the text color for the body rows of the comparison table.

Table borders

Sets the border color used between rows and columns in the comparison table.

Enable alternating row color

When enabled, odd and even rows in the comparison table use different background colors, making it easier to scan across wide tables. Turning this on reveals the Striped background color setting.

Striped background color

Sets the background color for alternating rows when the striped table option is enabled. Only appears when Enable alternating row color is turned on.

Category Restriction

Category Restrict Type

Controls whether the compare button is shown for all product categories or restricted to specific ones. The choices are:

  • None shows the compare button on all products regardless of category.
  • Exclude hides the compare button for products in the categories you select below.
  • Include shows the compare button only for products in the categories you select below.

Restricted Categories

A multi-select dropdown listing all your WooCommerce product categories. Only appears when the Category Restrict Type is set to Exclude or Include. Select the categories you want to include or exclude from comparison.

Table Layout

Table View Type

Controls the orientation of the comparison table. "Show as column" displays each product as a column with field names on the left, which is the traditional comparison layout. "Show as row" displays each product as a row with field names across the top, which can work better when comparing many fields but few products.

Fields Order

A drag-and-drop list of all available comparison fields. You can reorder fields by dragging them, and toggle each field's visibility on or off. The available fields are:

  • Name shows the product name as a link to the product page.
  • Price shows the product price, including sale prices when applicable.
  • Rating shows the product's star rating.
  • Description shows the product's short description.
  • SKU shows the product's SKU identifier.
  • Stock Availability shows whether the product is in stock.
  • Attributes shows product attributes such as color, size, or material. Each attribute creates its own row.
  • Custom Product Tabs shows content from custom product tabs. This field only appears when the Product Tabs Manager module is also active.
  • Add to Cart Button shows an add-to-cart button for each product in the comparison.

The sticky bar is the floating bar that appears at the bottom of the screen while customers browse, showing which products they have selected for comparison.

Background Color

Sets the background color of the sticky comparison bar.

Text Color

Sets the text color of the sticky comparison bar.

Button Type

Controls the visual style of the "Compare" button in the sticky bar. "Primary" uses a filled, prominent button style. "Secondary" uses a more subtle outlined style.

Compare Button Options

Icon

Selects which icon appears on the compare button shown on product cards. Three built-in compare icon styles are available, plus a custom SVG option. When you select the custom SVG option, a text area appears where you can paste your own SVG markup.

Custom SVG content

Paste a valid <svg> element to use as the compare icon. Only appears when the custom SVG icon option is selected above. Recommended SVG dimensions are width 16 and height 16. Fill attributes on <path> elements are ignored so that the button styling controls the icon color.

Advanced Product Reviews

These settings appear under WooCommerce > Settings > Products, in the General section, below the standard Product Rating Options. They are only present when the Advanced Product Reviews module is activated on the Sparks dashboard.

Allow users to attach images to reviews

When enabled, customers can upload images alongside their written reviews. This adds social proof to your product pages and helps other shoppers see real-world photos. Customers can attach up to five images per review.

Display reviewer name anonymized

When enabled, reviewer names are displayed as initials instead of full names (for example, Jane Doe appears as J.D.). Turn this on if your customers prefer privacy or if your store serves a market where anonymous reviews build more trust.

Hide reviewer profile picture

When enabled, the reviewer's Gravatar or profile picture is hidden from the review display. Use this alongside or instead of name anonymization if you want fully anonymous-looking reviews.

Enable review title

When enabled, customers can add a title to their review in addition to the review body text. Titles give other shoppers a quick summary of the review sentiment at a glance and make the review section easier to scan.

Enable review voting

When enabled, other users can vote reviews as helpful or unhelpful. This helps surface the most useful reviews and gives reviewers positive feedback. Turning this on reveals the unregistered voting option below.

Allow unregistered users to vote

When enabled, visitors who are not logged in can vote on reviews. Only appears when Enable review voting is turned on. Disable this if you want to restrict voting to registered customers to reduce the risk of vote manipulation.

Multi-Announcement Bars

Announcement bars are managed as a custom post type. Navigate to Marketing > Announcement Bars to create and manage them. This menu item only appears when the Multi-Announcement Bars module is activated on the Sparks dashboard.

Each announcement bar is created in the WordPress block editor using a dedicated Sparks block. The block provides a rich text content area for your message and a single button for your call to action. Settings are configured through panels in the block editor's right sidebar.

Display Location

Show on cart

When enabled, this announcement bar appears on the cart page. Use this to show messages like free shipping thresholds or upsell offers while customers review their cart.

Show on checkout

When enabled, this announcement bar appears on the checkout page. Use this for last-minute offers or important order information.

Show on product catalog

When enabled, this announcement bar appears on the shop page and product category archive pages. Use this for store-wide promotions visible while customers browse.

Show on single product

When enabled, this announcement bar appears on individual product pages. Use this for product-specific promotions or urgency messages.

Display Settings

Display notice for

Controls which visitors see this announcement bar. "All users" shows it to everyone. "Registered users" limits the bar to logged-in customers only. Use the registered-only option for loyalty offers or messages that reference account-specific information.

Start date

Sets when the announcement bar begins displaying. Defaults to "Immediately" if left empty. Set a future date to schedule a promotion ahead of time.

End date

Sets when the announcement bar stops displaying. Defaults to no end date if left empty. When an end date is set, you can use the {time_left} magic tag in your message to show a countdown, creating urgency.

Display Conditions

Trigger

Controls under what conditions the announcement bar appears. The choices are:

  • Always shows the bar whenever the location conditions are met, with no further rules.
  • Cart amount shows the bar only when the customer's cart total falls within a range you define. Selecting this reveals the cart amount fields below.
  • Product in cart shows the bar only when specific products are in the customer's cart. Selecting this reveals the product selection fields below.
  • Category in cart shows the bar only when products from specific categories are in the cart. Selecting this reveals the category selection fields below.

Maximum cart amount

Sets the upper cart total threshold. The bar appears only when the cart total is at or below this amount. Only appears when the trigger is set to Cart amount. Use this with the {amount_left} magic tag to show customers how much more they need to spend to reach a goal like free shipping.

Minimum cart amount

Sets the lower cart total threshold. The bar appears only when the cart total is at or above this amount. Only appears when the trigger is set to Cart amount.

Should include tax

Controls whether tax is included when calculating the cart total against your amount thresholds. Defaults to "Yes." Only appears when the trigger is set to Cart amount. Set this to match how your store displays prices to avoid confusing mismatches.

Include (products)

A searchable field where you select specific products that must be in the cart for the bar to appear. Only appears when the trigger is set to Product in cart. When products from this list are in the cart, you can use the {products_in_cart} magic tag to display their names in the message.

Exclude (products)

A searchable field where you select products that prevent the bar from appearing when they are in the cart. Only appears when the trigger is set to Product in cart.

Minimum quantity

The bar appears only when the matched product's quantity in the cart is at or above this number. Only appears when the trigger is set to Product in cart. Use with the {quantity_over} magic tag to show how many items over the minimum the customer has added.

Maximum quantity

The bar appears only when the matched product's quantity in the cart is at or below this number. Only appears when the trigger is set to Product in cart. Use with the {quantity_left} magic tag to show how many more items the customer can add.

Include (categories)

A searchable field where you select product categories that must be represented in the cart for the bar to appear. Only appears when the trigger is set to Category in cart. Use the {categories_in_cart} magic tag to display the matching category names in the message.

Exclude (categories)

A searchable field where you select product categories that prevent the bar from appearing when products from those categories are in the cart. Only appears when the trigger is set to Category in cart.

Styling

Background color

Sets the background color of the announcement bar. Choose from the theme's color palette. Adjust this to make the bar stand out from or blend into your page design.

Button Settings

When the call-to-action button in the announcement bar is selected, an additional panel appears in the sidebar.

Automatically add to cart

When enabled, clicking the button adds a product to the customer's cart automatically. The product is determined by the URL you set on the button (it should be a product link). Use this for one-click upsells or quick-add promotions.

Automatically apply discount

When enabled, a coupon code is automatically applied to the cart when the button is clicked. Only appears when Automatically add to cart is turned on.

Discount code

The WooCommerce coupon code to apply when the button is clicked. Only appears when Automatically apply discount is turned on. The coupon must already exist in WooCommerce > Marketing > Coupons.

Magic Tags

The announcement bar content editor includes a Magic Tags toolbar button. Magic tags are dynamic placeholders you can insert into your message that are replaced with live values on the front end. Each tag is only available when the relevant trigger or setting is configured:

  • {time_left} inserts a countdown to the end date. Available when an end date is set.
  • {amount_left} inserts the remaining amount to reach the maximum cart threshold. Available when the trigger is Cart amount and a maximum amount is set.
  • {products_in_cart} inserts the names of matching products currently in the cart. Available when the trigger is Product in cart and products are included.
  • {quantity_left} inserts how many more items can be added before the maximum quantity is reached. Available when the trigger is Product in cart and a maximum quantity is set.
  • {quantity_over} inserts how many items above the minimum quantity the customer has added. Available when the trigger is Product in cart and a minimum quantity is set.
  • {categories_in_cart} inserts the names of matching categories represented in the cart. Available when the trigger is Category in cart and categories are included.

Custom Thank You Pages

Thank you pages are managed as a custom post type. Navigate to Marketing > Thank You Pages to create and manage them. This menu item only appears when the Custom Thank You Pages module is activated on the Sparks dashboard.

Each thank you page is created in the WordPress block editor (or Elementor, if installed). After checkout, the plugin checks all thank you pages in order of priority (page order) and redirects the customer to the first one whose conditions match their order. Settings are configured through panels in the block editor's right sidebar.

Products

A searchable field where you select specific WooCommerce products. When any of these products are in the customer's order, they see this thank you page. A product can only be assigned to one thank you page at a time. Leave empty to match all products.

Redirect URL

An optional URL field. When set, customers who match this thank you page's conditions are redirected to this external URL instead of viewing the page content. Use this when you want to send customers to an external survey, onboarding flow, or partner site after purchase.

Shipping Methods

A list of checkboxes showing all shipping methods configured in your WooCommerce shipping zones, formatted as "Zone Name - Method Title." Check the methods that should trigger this thank you page. Leave all unchecked to match any shipping method. If no shipping methods are configured in WooCommerce, a message indicates that you need to add some first.

Payment Gateway

A list of checkboxes showing all payment gateways configured in WooCommerce. Check the gateways that should trigger this thank you page. Leave all unchecked to match any payment gateway. If no gateways are configured, a message indicates that you need to add some first.

Categories

On the WooCommerce product category edit screen, a Custom Thank You Page dropdown appears where you can assign one or more thank you pages to a category. Any order containing a product from that category will match the assigned thank you page.

Per-Product Assignment

On the product edit screen under the Product Data section, a Thank You Page tab appears where you can select a specific thank you page for that product from a dropdown. This overrides category-level assignments for that product.

Product Tabs Manager

Product tabs are managed through a custom post type and a per-product editor. The global tabs list is at WooCommerce > Product Tabs. Per-product tab customization is on the Product Data section of each product's edit screen. Both are only available when the Product Tabs Manager module is activated on the Sparks dashboard.

Global Tabs List

Navigate to WooCommerce > Product Tabs to see all global tabs. The list includes three core tabs that WooCommerce provides by default (Description, Reviews, and Additional Information) plus any custom global tabs you create.

Visibility

Each tab in the list has a toggle switch that controls whether it appears on product pages. Hiding a core tab here hides it across all products unless overridden at the product level. This is useful when you want to remove the Additional Information or Reviews tab store-wide without code.

Sorting

A Sorting view is available in the list table that lets you drag and drop tabs to set their display order. The order you set here is the default order used on all product pages unless overridden at the product level. There is a maximum limit of 100 global tabs.

Categories

When editing a custom global tab, you can assign it to specific product categories using the Product Categories taxonomy. When categories are assigned, the tab only appears on products belonging to those categories. Leave categories empty to show the tab on all products.

Per-Product Tab Customization

On the product edit screen, a Product Tabs panel appears in the Product Data section for Simple and Variable products.

Use Global Tabs / Customize Tabs

A toggle switch at the top of the panel controls whether this product uses the global tab configuration or a custom one. When set to Use Global Tabs (the default), the panel shows a read-only preview of the global tabs that will appear on this product. When switched to Customize Tabs, the full tab editor appears.

In the customized view, you can:

  • Drag tabs to reorder them for this product only.
  • Remove any tab (including core tabs) from this specific product.
  • Add custom tabs unique to this product by clicking Add Custom Tab and choosing Custom Tab. Each custom tab has a Title field and a Content field with a text editor.
  • Add existing global tabs that are not already included by selecting them from the Add Custom Tab dropdown.
  • Edit global tab content by clicking the edit button, which opens the global tab's edit page.