Visual Editor

The Commerce Studio Visual Editor lets you configure search ranking rules, manage product boosting and blocking, set facets, and preview search results in real time to optimize product visibility. To access it, go to your site in Commerce Studio and click Commerce Studio > Editor.

If the editor doesn’t display items in the expected format, you might need to configure Commerce Studio’s settings.

Click below for a short demo about the features you’ll find in the editor:

Use the Conditions Manager

At the top of the Visual Editor you’ll find the Conditions Manager. This is where you set the conditions for any rules you create in Commerce Studio, such as the query, timeframe, category, and more.

When you hold the pointer over the Conditions Manager, it expands to display the page controls:

Select a search profile to preview

The Preview dropdown shows you the available search profiles. Query profiles represent different predefined search results that you can display on different pages of your customer-facing site, such as new items, seasonal items, sale items, and so on. You might also have experimental query pipelines for testing different configurations.

Use search conditions

When Search is selected in the Conditions Manager, you can enter queries and see the results in the live preview:

You can enter multiple queries, then click to switch between them in the live preview:

You can also filter results by tags or by date range.

Use category conditions

When you select Category in the Conditions Manager, you can type to search for categories, then select one or more to display in the live preview:

Just like search conditions, you can enter more than one category, then click to switch between them in the live preview:

Configure the item card display

The fields displayed in the Visual Editor for any search profile are configured on the Settings screen. Once those are configured, you can click Preview Settings in the Visual Editor to toggle whether each field is displayed or hidden, including these:

• Item fields, such as the title, description, image, and so on.
• Variants such as color or image variants
• Metric fields such as add-to-cart (ATC), conversion rate (CVR), revenue per visit (RPV), and more.

View and modify rules

In the Execute panel on the left side of the Visual Editor, you can view the rules that apply to the current query or category, including draft rules and published rules:

When you click a specific rule, the Rule Details section displays. You can view rule information such as name, creation information, and the action such as boost or bury.

In addition, you can scroll to see other information such as the history of changes to the rule, conflicts with other rules, and items linked to the rule.

You can edit, delete, or duplicate the rule. If the rule status is Draft you can click Publish to make the rule active on your site. If the rule status is Published, you can click Unpublish to deactivate the rule.

Create new rules

When you create a new rules in the Visual Editor, the rule is triggered by the current query or category in the Conditions Manager. For example, when “party supplies” is the current query and you create and publish a rule, the rule is triggered only when end users search for “party supplies”. Likewise, when “Rugs” is the current category, a new rule is triggered only when end users view the “Rugs” category on your site.

There are several ways to create new rules in the Visual Editor:

• Click Create Rule in the Execute panel to create a new rule of any kind.
• Hold the pointer over any facet and click to create a facet rule.
• Hold the pointer over any item card and click the controls to create a rule that applies that item.
• Select the checkboxes for multiple items, then click the controls to create a rule that applies to that set of items.

View product details

If you Click for details, the Product details panel displays and provides the following information: product name, image, position (ranking in results), triggered rules for the item, and the item analytics selected to view.

Ranking insights

This section displays the ranking factors for the results. Factors include sort such as relevance score, the query processing such as phrase detections, and selected analytics such as total revenue, total searches, and total purchases.