Customize the Background for a Milestone
Each milestone can have its own background color and image, or it can inherit the look from its parent journey or hub. Open the milestone's Settings → Customize tab, turn on Customize background, and choose a solid color, gradient, or uploaded image.
By default, every milestone inherits its background from the journey it belongs to — and if the journey doesn't have a custom background, it pulls from the hub. You can override this at any time by giving a milestone its own background color, gradient, or image.
Where to find background settings
Open the milestone you want to customize, then select Settings → Customize. The background controls are at the top of the Customize tab.
How inheritance works
Backgrounds flow down a chain: Hub → Journey → Milestone. A milestone first checks whether it has its own background. If not, it uses the journey's. If the journey doesn't have one either, it falls back to the hub's.
When you're on the Customize tab, the label next to each field tells you where the current value is coming from — for example, Inherited from Journey "Getting Started" or Inherited from Hub "My Hub". This makes it easy to see at a glance what you'd be overriding.
Set a custom background
Turn on the Customize background toggle at the top of the section. Once enabled, you can change the color, the image, or both.
Background color
You have three options for the color:
- None — No color overlay. The milestone shows only the background image (if any) or a plain white/dark background based on your hub's theme.
- Solid — A single color. Pick any hex color and adjust the opacity slider to control how transparent it is.
- Gradient — A blend of two colors. Choose a start and end color, set the opacity, and pick a direction: Top to Bottom, Bottom to Top, Diagonal, or Radial.
If you add both a color and an image, the color renders as an overlay in front of the image — useful for tinting a photo or adding a semi-transparent wash.
Background image
Upload any image file. Once uploaded, choose how it fills the space:
- Cover (default) — The image scales to fill the entire area. It may be cropped at the edges, but there are no blank gaps.
- Contain — The image fits entirely within the area. You see the whole picture, but there may be space around it.
Use the Preview button in the upper-right corner to see how the background looks to your members before saving.
Reset to inherited background
To remove a milestone's custom background and go back to inheriting from the journey or hub, turn off the Customize background toggle. You'll see a confirmation dialog — once confirmed, the custom color and image are cleared and the milestone picks up whatever the journey (or hub) provides.
Background settings at other levels
The same background options are available at every level in your hub:
- Hub — Hub Settings → General. This is the default background that everything else inherits from.
- Journey — Journey Settings → Customize. Overrides the hub for all milestones in that journey (unless a milestone has its own).
- Milestone — Milestone Settings → Customize. Overrides the journey for that specific milestone.
- Conversations — Hub → Conversation Templates → Settings → Background. Conversations have their own separate background that doesn't inherit from the milestone chain.
Steps use their milestone's background automatically — there's no separate background setting for individual steps.
Frequently asked questions
- What does 'Inherit' mean for milestone backgrounds?
- Inherit is the default. It means the milestone uses whatever background its journey has. If the journey doesn't have a custom background either, it pulls from the hub. You only need to turn on Customize background if you want this specific milestone to look different.
- Can I set a background on just one milestone without affecting the others?
- Yes. Background settings are per-milestone. Turning on Customize background and picking a color or image only affects that milestone. Other milestones in the same journey keep inheriting unless you customize them individually.
- What's the difference between Cover and Contain for background images?
- Cover fills the entire area — the image may be cropped at the edges to avoid gaps. Contain fits the whole image inside the area — you'll see the full picture, but there may be blank space around it. Cover is the default and works best for most photos and textures.
- Where do I set a background for the hub or journey level?
- For the hub, go to Hub Settings → General. For a journey, go to the journey's Settings → Customize. Conversations have their own background under Hub → Conversation Templates → Settings → Background. Steps automatically use their milestone's background.
