Value of optional type '...' not unwrapped

The “Value of optional type not unwrapped” error means you are trying to use an optional value where a non-optional is expected. Swift requires you to unwrap optionals before using them.

What It Means

Optionals in Swift are a distinct type (Optional<Wrapped>), not the underlying value. An Int? is not an Int — it is a box that either contains an Int or is nil. You cannot pass an Int? to a function expecting Int, concatenate a String? with a String, or assign an optional to a non-optional variable. The compiler enforces unwrapping before use.

Why It Happens

• Optional return value used directly — a method returns String? but you assign it to String.
• Dictionary subscript access — accessing a dictionary key returns an optional.
• Optional property accessed without unwrapping — a struct or class property is T? but used as T.
• Function parameter mismatch — passing a String? argument to a parameter typed String.
• Optional chaining result — using ?. produces an optional that needs further handling.

How to Fix It

1. Use if let to conditionally unwrap

let optionalName: String? = "John"
// ❌
let greeting = "Hello, " + optionalName

// ✅
if let name = optionalName {
    let greeting = "Hello, " + name
}

2. Use guard let for early exit

func greet(_ name: String?) -> String {
    guard let unwrappedName = name else {
        return "Hello, Guest"
    }
    return "Hello, " + unwrappedName
}

3. Provide a default with nil coalescing

let username: String? = getUserInput()
// ✅ Default value when optional is nil
let displayName = username ?? "Anonymous"

4. Force unwrap only when guaranteed safe

// Only use ! when you are certain the value exists
let url = URL(string: "https://example.com")!

5. Use map on optionals

// Transform the value if it exists, nil otherwise
let countString: String? = optionalValue.map(String.init)