FAQ & troubleshooting

The questions merchants ask most often, and where to look first. For anything specific to one section, that section's article has more detail.

In the editor

A setting in these docs isn't in my editor

It probably only appears once another setting is on. Every setting like that has an Only appears when … line in its article. Switch that setting on and the one you're looking for will show up. See Theme editor basics.

My changes aren't showing on the store

Check, in order: that you clicked Save; that you're editing the theme that's actually published, not a copy in your theme library; and that the product or page you're looking at uses the template you edited. A product assigned to an alternate template won't pick up changes made to the default one. Your browser may also be showing an older version, so try a private window.

I can't find a section in Add section

Header, footer and overlay sections already live in their section group and can't be added to a page. Sections that show a page's own content, like the main product or collection section, only appear on that template. Each section article says where it can go.

Products

Color swatches are blank or missing

Swatches use the color or image assigned to each option value in the Shopify admin. An option value without one has nothing to show. Add them in the product's options, then make sure Show swatches is on. How swatches look is set in Theme settings → Color swatches.

Star ratings don't appear

Ratings come from Shopify's standard product rating metafields, which your reviews app fills in. See Metafields used by Sublime.

There's no size guide link

In the Product page variant picker block, switch on Show size guide link, then choose a Size guide page, a Size chart image, or both.

The product highlight label or key stats don't show

Both come from metafields with an exact namespace and key: custom.highlight and sublime.key_stats. See Metafields used by Sublime.

Collections and search

Filters aren't showing

Filters are created in Shopify's Search & Discovery app, not in the theme. Add them there, then check that Enable filtering is on in the Collection page.

Search suggestions don't appear as I type

Switch on Enable predictive search in the Search drawer.

Header, footer and overlays

Header text is invisible on the homepage

This almost always happens with a transparent header over a light image or section. When the header is transparent, it uses its own text color and logo, set under Enable transparent header in the Header. Pick ones that contrast with the first section on the page.

Social icons are missing

Icons only appear for networks that have a profile link in Theme settings → Social media.

The pop-up never appears, or appears every time

Look at Trigger and Show again after in the Pop-up. Show on home page only and Hide for account holders can also hide it while you test. Once it's closed, it stays hidden in that browser for the period you set, so use a private window to see it again.

The map in Store locator is blank

The interactive map needs a Google Maps API key. Without one, the section shows the fallback image instead. See Store locator.

Design

Can I use my own font?

The font pickers in Theme settings → Typography cover Shopify's font library. For a licensed font file, upload it under Content → Files and load it with Theme settings → Custom CSS.

Where do I change something the editor doesn't offer?

For visual changes, use Theme settings → Custom CSS for the whole store, or the Custom CSS field at the bottom of any section's settings for that section alone. Both are kept when you update Sublime. Edits to the theme's code files are not.

Spacing between sections looks wrong on mobile

Mobile reuses the desktop spacing unless you switch on Enable mobile spacing controls in that section. See Settings every section shares.

Still stuck?

Contact the Ascend Themes support team. To help us answer quickly, include your store URL, the theme's name as it appears in your theme library, the page and section involved, and a screenshot or screen recording of the problem.