How to Create a Slider in Unity: Step-by-Step Guide

To create a slider in Unity, add a Slider UI element from the GameObject menu under UI. Then, customize its properties and use Slider.value in scripts to get or set the slider's current position.

Syntax

The basic syntax to use a slider in Unity involves the Slider component from the UnityEngine.UI namespace. You access or modify the slider's value using slider.value. You can also listen to changes with slider.onValueChanged.

• Slider.value: float representing the current slider position.
• Slider.minValue and Slider.maxValue: define the slider's range.
• Slider.onValueChanged: event triggered when the slider value changes.

csharp

using UnityEngine;
using UnityEngine.UI;

public class SliderExample : MonoBehaviour
{
    public Slider slider;

    void Start()
    {
        slider.minValue = 0f;
        slider.maxValue = 100f;
        slider.value = 50f;

        slider.onValueChanged.AddListener(OnSliderChanged);
    }

    void OnSliderChanged(float value)
    {
        Debug.Log("Slider value: " + value);
    }
}

Output

When the slider is moved, the console logs: "Slider value: X" where X is the current slider value.

Example

This example creates a slider in the Unity UI, sets its range from 0 to 10, and prints the current value to the console whenever the slider is moved.

csharp

using UnityEngine;
using UnityEngine.UI;

public class SimpleSlider : MonoBehaviour
{
    public Slider mySlider;

    void Start()
    {
        mySlider.minValue = 0f;
        mySlider.maxValue = 10f;
        mySlider.value = 5f;

        mySlider.onValueChanged.AddListener(delegate { ValueChanged(); });
    }

    void ValueChanged()
    {
        Debug.Log("Current slider value: " + mySlider.value);
    }
}

Output

Console output example when slider moves: "Current slider value: 7.3" (value changes as slider moves)

Common Pitfalls

Common mistakes when creating sliders in Unity include:

• Not assigning the Slider component reference in the script, causing null reference errors.
• Forgetting to set the slider's minValue and maxValue, which defaults to 0 and 1 and may not fit your needs.
• Not subscribing to onValueChanged event properly, so changes are not detected.
• Trying to modify the slider value in Update() without conditions, which can cause jittery UI.

Wrong way:

void Start() {
    slider.onValueChanged.AddListener(OnSliderChanged);
}

void OnSliderChanged(float value) {
    // No slider reference assigned, causes error
    Debug.Log(value);
}

Right way:

public Slider slider;

void Start() {
    if (slider != null) {
        slider.onValueChanged.AddListener(OnSliderChanged);
    }
}

void OnSliderChanged(float value) {
    Debug.Log(value);
}

Quick Reference

Here is a quick summary of important slider properties and methods:

Property/Method	Description
value	Current float value of the slider
minValue	Minimum allowed value
maxValue	Maximum allowed value
onValueChanged	Event triggered when value changes
wholeNumbers	If true, slider only allows integer values

Key Takeaways

Add a Slider UI element from the GameObject > UI menu to create a slider.

Use slider.value to get or set the slider's current position programmatically.

Always assign the Slider component reference in your script to avoid errors.

Subscribe to slider.onValueChanged to react when the slider moves.

Set minValue and maxValue to define the slider's range clearly.