Skip to content
Tutorial Reference

How to Convert RGB to Hex Codes in Python

Learn how to convert RGB color tuples to valid hexadecimal codes in Python using f-strings, format specifiers, and best practices for zero-padding and input validation.

In digital design and web development, colors are often manipulated as RGB tuples, (Red, Green, Blue) integers ranging from 0 to 255, but required by CSS and HTML as Hexadecimal strings (e.g., #FF5733).

This guide explains how to efficiently convert RGB values to Hex codes using Python's string formatting capabilities, specifically focusing on f-strings and handling common formatting pitfalls like zero-padding.

Understanding the Data Formats

  • RGB: Represented as a tuple of three integers, e.g., (255, 0, 128).
  • Hex: A string starting with # followed by 6 characters (0-9, A-F). Each pair of characters represents a color channel in base-16.

Introduced in Python 3.6, f-strings provide the most readable and concise way to perform this conversion.

The format specifier :02x is the key:

  • 0: Pad with zeros if the number is small.
  • 2: Ensure the output is at least 2 characters wide.
  • x: Convert to lowercase hexadecimal (use X for uppercase).
rgb = (255, 165, 0) # Orange

r, g, b = rgb

hex_code_lower = f"#{r:02x}{g:02x}{b:02x}"
hex_code_upper = f"#{r:02X}{g:02X}{b:02X}"

print(f"Lower: {hex_code_lower}")
print(f"Upper: {hex_code_upper}")

Output:

Lower: #ffa500
Upper: #FFA500

Method 2: Using the format() Method

For older Python versions (pre-3.6), the .format() string method is the standard approach. It uses the same format specifiers as f-strings.

rgb = (0, 128, 255) # A shade of blue

hex_code = "#{:02X}{:02X}{:02X}".format(*rgb)

print(f"Hex: {hex_code}")

Output:

Hex: #0080FF

Common Pitfall: Missing Zero Padding

A standard hex code must be 6 characters long (plus the hash). A common mistake is using the standard hex() function or simple formatting without padding. If a color value is less than 16 (e.g., 10), it converts to a single digit (a), resulting in an invalid hex code like #fa5 (ambiguous length).

r, g, b = (255, 10, 5)

bad_hex = f"#{r:x}{g:x}{b:x}" 
print(f"Invalid Hex: {bad_hex}") 

good_hex = f"#{r:02x}{g:02x}{b:02x}"
print(f"Valid Hex:   {good_hex}")

Output:

Invalid Hex: #ffa5
Valid Hex:   #ff0a05

Common Pitfall: Values Out of Range

RGB values must be between 0 and 255. If user input provides values outside this range (e.g., 300 or -50), the conversion will result in nonsense hex codes unless you clamp the values.

def to_hex_safe(r, g, b):
    
    r = max(0, min(r, 255))
    g = max(0, min(g, 255))
    b = max(0, min(b, 255))
    
    return f"#{r:02X}{g:02X}{b:02X}"

print(to_hex_safe(300, 100, -20))

Output:

Conclusion

To convert RGB integers to Hex strings in Python:

  1. Use f-strings (f"#{r:02x}{g:02x}{b:02x}") for modern, readable code.
  2. Use X for uppercase and x for lowercase hex digits.
  3. Always include :02 to pad single-digit hex numbers with a leading zero.
  4. Clamp inputs if there is a risk of data falling outside the 0-255 range.
Navigation