Ecom Store Pro

Can you use a gradient background in a Shopify theme?

Updated ·
At a glance
Short answer
Yes, in some areas, if your theme has a Background gradient field; if the gradient can't be applied, the Background color setting applies instead
Where to look
Edit theme > Theme settings > Colors > Schemes > a scheme > gradient swatch
Which themes
Depends on theme version, setting and developer; no page we read lists themes with the field
CSS mode
Linear, radial or conic gradients, which can repeat; no image backgrounds
No field
CSS in the theme code editor, or Custom CSS, which doesn't reach checkout

Where is the Background gradient field?

Background gradient is its own color input field, beside Color and Color scheme. Shopify's theme developer docs describe its setting type, color_background, which the theme's developer adds, so whether your theme has it is the theme author's call.

In Shopify adminOpen in your store
  1. Online Store
  2. Edit theme
  3. Theme settings
  4. Colors
  5. Schemes
  6. your scheme
  7. Background gradient
Each scheme in this Schemes list opens its own color fields.

Click the gradient swatch, pick a preset, then Save.

No Shopify page we read on October 16, 2026 (Help Center color, theme settings and Custom CSS pages, theme developer docs, changelogs) lists which themes have the field, or says whether themes on color palettes, such as Horizon 4.0.0 and later, have it. On a draft of Horizon 4.3.0 on our development store on October 23, 2026, Theme settings > Color palette had no Background gradient field: the first swatch we opened showed a plain color picker. So open a scheme in your own theme and look for the swatch.

In Shopify adminOpen in your store
  1. Online Store
  2. Edit theme
  3. Theme settings
  4. Color palette
Horizon 4.3.0's first palette swatch opens a plain color picker, with no gradient option.
In Shopify adminOpen in your store
  1. Online Store
  2. Edit theme
  3. Theme settings
  4. Colors
  5. Schemes
  6. your scheme
Open a scheme and look for this swatch beside Background.

Schemes or palettes? See how to change your store's background color.

No swatch in your scheme? Use CSS instead.

What can you set in the gradient picker?

The first time, the picker offers presets; select one to open the options, previewed live:

  • colors, by hex code or slider
  • linear or radial style
  • angle
  • position
  • opacity
In Shopify adminOpen in your store
  1. Online Store
  2. Edit theme
  3. Theme settings
  4. Colors
  5. Schemes
  6. your scheme
  7. Background gradient
Pick one of these presets first; the options listed above open after that.
In Shopify adminOpen in your store
  1. Online Store
  2. Edit theme
  3. Theme settings
  4. Colors
  5. Schemes
  6. your scheme
  7. Background gradient
After a preset is picked, the picker opens these fields, previewed live in the store.

For CSS instead, click the arrow next to Gradient, select CSS and paste code into the CSS code field: linear, radial and conic gradients, which can repeat. Shopify's theme developer docs add that the color_background setting type doesn't support image backgrounds.

In Shopify adminOpen in your store
  1. Online Store
  2. Edit theme
  3. Theme settings
  4. Colors
  5. Schemes
  6. your scheme
  7. Background gradient
Switch Gradient to CSS with the arrow, then paste code into this field.

Remove gradient, then Save, takes a gradient off.

In Shopify adminOpen in your store
  1. Online Store
  2. Edit theme
  3. Theme settings
  4. Colors
  5. Schemes
  6. your scheme
  7. Background gradient
Remove gradient sits at the bottom of the picker, under Currently used colors.

What if a gradient can't be used?

Per Shopify's Help Center, a gradient covers background elements only in some areas of your theme. If the gradient can't be applied, the Background color setting applies instead, so pick one you're happy to show.

No gradient field? Use CSS in the theme code editor, which includes a validation checker, or Custom CSS in theme settings. Custom CSS overrides your theme's settings, doesn't reach checkout and has a character limit.

About This Article

This page was written by AI. Separate AI agents that did not write it check its figures and claims against official sources and test its links and interactive tools. A human editor sets the site's editorial direction, topics and rules and checks that pages are complete and display correctly, but does not check their facts or edit their text. Details may change — always confirm critical data at shopify.com.

Editorial Policy

Related questions

Products & inventory
How do you create a second collection template in Shopify?

In the theme editor pick Collections, click Create template, then set Theme template on each collection — not on Starter or a Vintage theme.

October 22, 2026

Online store & themes
How do you edit the Shopify blog post template in code?

In Edit code, templates/article.json (Online Store 2.0) names the post's section; that section's file and any theme blocks it renders hold the code.

October 21, 2026

Online store & themes
How do you set a focal point on an image in Shopify?

Click an image in Files, the theme editor or a product, then click its spot and Save; works on supported themes only.

October 15, 2026

Stay updated

Get notified about new articles

Subscribe to receive updates when we publish new Shopify guides and insights.