Split FAQ
Split FAQ: answers to common questions about the split-screen layout, images, the header, product pages, the cart, updates and support.
Applies to: Split 5.1.0 and later. Added in: Split 1.0.0. Last checked: 2026-10-13 against Split 5.1.0.
Short answers to the questions Split customers ask most, each with the page that explains it in full.
Which Split version do I have?
Your version is shown in Shopify admin → Online Store → Themes, under the theme's name. These docs describe Split 5.1.0. To install the newest version, see Update Split, and see What's new for the changes in each release.
Why are my images cropped?
Because Split fills boxes measured in fractions of the screen, such as half the width and the full height. An image with another shape is cropped to fill its box, and the crop changes with the size of the screen.
- Keep the subject in the center and use the sizes in Image size recommendations.
- For an image without cropping, use the Image section: it shows the image at its natural height.
Why does my section look different on mobile?
Because the two halves of a split section stack on phones and on tablets held upright. Each half then takes the full width, and heights follow the content instead of the screen. See How Split is built.
Why is the title on the left not scrolling with the page?
Because it is a sticky half. In two-half sections such as the Regular page, the collection page and the product page, one half stays in place on desktop while the other half scrolls. See How Split is built.
Can I move the logo or the menu in the header?
No. Split has no settings to change the header layout: the logo sits on the left, and the menu and icons on the right. Moving them needs custom code. See Header section and Custom work and code changes.
Why does my map not show?
Usually because the Google Maps API key is missing, restricted to other domains, or its project has no billing account or lacks the two APIs Split needs. Each Map section and each Contact Form section has its own Google Maps API key field. See Map section.
How do I set up color swatches?
Make sure the option name is in Theme settings → Product card → Color swatches labels, then give each value a swatch: Shopify's color metafield, an image named after the value, or a CSS color name. See Product card theme settings.
How do I add filters to collection pages?
Install Shopify's Search & Discovery app and choose the filters there, then turn on Enable filtering in the Collection page section. Shopify controls which filters exist. See Collection page.
Why do the additional checkout buttons disappear in the cart?
Because Shopify draws them, not Split. Shopify can hide them after the cart changes, and the theme cannot style them. See Cart theme settings.
Why does a product page not show the promotion I set?
Because the Promotional banner shows only when its section is on and has a title, subtitle or link, from the section or from the product's promo_banner metafields. See Promotional banner section.
How do I get help?
Contact Krown support at contact.krownthemes.com. Include your store URL or a preview link and the page where the problem happens. Support covers the theme settings and theme bugs; see Custom work and code changes for what it does not cover.
Related pages
- What Split does not do: the limits of Split and what to do instead.
- Custom work and code changes: what Krown support covers and what needs a developer.
- Sections: every section and the page that documents it.
- Shopify basics for Split stores: Shopify topics that are not theme settings.