search
Learn more

FAQs

chevron-rightHow do I translate category titles?hashtag

We architected Ultra Categories with translations in mind. Once you've installed Shopify's Translate & Adapt apparrow-up-right, follow these instructions depending on which content you want to add translations for:

  • Category titles: In the Translate & Adapt app, navigate to Metaobjects, then search for the display title, e.g. "Women". Enter the translation for each language.

  • All other visible text, e.g. prefix label, home: In the Translate & Adapt app, navigate to templates. Depending on which app block you're using, choose Collection and/or Product template and edit the relevant Ultra Categories fields.

chevron-rightWhy are my subcollections not displaying?hashtag

  • Ensure you've added the subcollections block to the collection template you're viewing.

  • Check you're previewing a collection that appears in the category tree and that has child categories.

  • The app should prevent you from using the same collection multiple times in the category tree, however double check that the collection you're viewing only appears once in the category tree. If not, the wrong collection might be picked up by the app.

chevron-rightWhy are my product breadcrumbs not appearing or incorrect?hashtag

  • Ensure you've added the product breadcrumbs block to the product template you're viewing.

  • Ensure the product you're viewing has been added to all the relevant collections in the Shopify admin.

  • Check the product breadcrumbs logic: Are collection-aware URLs enabled in your theme? Have you set a "base collection" metafield that's overriding the other logic?

  • The app should prevent you from using the same collection multiple times in the category tree, however double check that the collection you're viewing only appears once in the category tree. If not, the wrong collection might be picked up by the app.

chevron-rightThere's extra space on collections when the subcollections block doesn't appear. How do I hide the block when it's empty?hashtag

The subcollections block doesn't display when the current category has no child (or sibling categories, when enabled). However, even when there are no categories, if you've added padding to the containing section, that padding will always show regardless.

There are two options to resolve this:

  • Remove the section padding and use the block's Vertical padding instead

  • Add some custom CSS to the section to remove this space when the category list is empty. For this, you'll need to find out if the section has a class (replace section-class with the correct class) and then hide it if it doesn't contain the category list element.

.section-class:not(:has(.uf-uc-catlist)) {
  display: none;
}
chevron-rightHow do I match the content width to my theme?hashtag

You can adjust the Content width setting (defaults to 1400px). However, you may also need to manually adjust the outer margin variable (the padding either side of content) to fully match your theme on smaller screens.

Find out what outer margin value your theme is using and then override it like so in the section's Custom CSS field. You may need to add media queries if the values change depending on the screen size.

.uf-uc-catlist {
  --uf-uc-catlist-container-outer-margin: 20px;
}
chevron-rightHow do I change the color of the slider controls in the subcollections block?hashtag

The slider control background color is inferred from currentColor . You can override the value like so in the section's Custom CSS field.

.uf-uc-catlist__control {
  --uf-uc-catlist-color-control-background: #000000;
}

The icon is inverted based on the background color using CSS filter.

Last updated