How to Inspect and Control CSS list-style-type in Safari Web Inspector

In web typography and structured content design, ordered and unordered lists (<ol> and <ul>) convey hierarchies, sequential procedures, and navigation menus. The CSS list-style-type property dictates the visual glyph, numerical numbering format, or alphabetical sequence displayed alongside each list item marker.

While standard values like disc, circle, and decimal are widely supported, WebKit in Safari provides robust support for comprehensive international numeral systems—including cjk-decimal, hiragana, hebrew, armenian, and georgian—as well as modern keyword values like disclosure-open, disclosure-closed, and arbitrary string markers (e.g., list-style-type: "👉 "). This tutorial demonstrates how to inspect, test, and control list-style-type values using Safari Web Inspector.

Understanding CSS list-style-type and Marker Rendering in WebKit

The list-style-type property modifies the contents of the pseudo-element marker (::marker) generated by any element with display: list-item.

Supported keyword categories include:

  • Unordered Glyphs: disc (default for <ul>), circle, square, and none.
  • Numeric Systems: decimal, decimal-leading-zero, arabic-indic, devanagari, and bengali.
  • Alphabetic and Classical Systems: lower-alpha, upper-alpha, lower-roman, upper-roman, lower-greek, hiragana, and katakana.
  • Interactive UI Symbols: disclosure-open and disclosure-closed (commonly used for collapsible accordion widgets).
  • Custom String Literals: Strings such as list-style-type: "✓ " or emoji characters ("📌 ").

Because lists inherit properties down through nested sub-lists, inspecting the computed styles in Safari Web Inspector helps identify why bullet formats inadvertently revert or fail to align.

Step 1: Open Safari Web Inspector

  1. Launch Safari on macOS.
  2. Ensure developer features are enabled under Safari > Settings > Advanced by ticking Show features for web developers.
  3. Navigate to the webpage containing the list elements you want to evaluate.
  4. Right-click the target bullet point or list container and choose Inspect Element (or press Cmd + Option + I).
  5. Ensure the Elements tab is selected in the Web Inspector top navigation bar.

Step 2: Inspect list-style-type in the Styles Pane

  1. In the DOM tree, locate the parent <ul>, <ol>, or individual <li> element.
  2. In the right-hand panel, inspect the Styles sub-pane.
  3. Locate the rule applying list-style-type or shorthand list-style (e.g., list-style: square inside;).
  4. Click the Computed tab to verify the final resolved value assigned by WebKit after processing cascade inheritance and user-agent stylesheets.

Step 3: Modify and Test Values Live in Web Inspector

You can test different bullet formats directly within Safari without modifying your local source files:

  1. Double-click the value next to list-style-type in the Styles pane.
  2. Replace the existing value with another keyword (e.g., change disc to square or lower-roman).
  3. Observe the browser window: WebKit repaints the bullet indicators instantaneously.
  4. Test Custom Emoji / String Markers: Type a quoted string, such as "🔥 " or "➔ ". Safari immediately displays the custom string as the marker prefix before each item.
  5. Test Collapsible Disclosure Indicators: Set the value to disclosure-closed or disclosure-open to see standard OS-native disclosure triangles.

Step 4: Inspecting the ::marker Pseudo-Element

To style or inspect the specific font, colour, and positioning applied directly to the bullet glyph:

  1. In the DOM tree, expand the target <li> element.
  2. Safari Web Inspector reveals the internal shadow/pseudo node: ::marker.
  3. Select ::marker to inspect its distinct CSS properties in the Styles pane.
  4. You can assign unique colors, font sizes, or animations to the marker without altering the adjacent body text:
    li::marker {
      color: #2563eb;
      font-size: 1.2em;
    }

Troubleshooting Common List Marker Issues

  • Markers Overlap Container Margins: By default, list markers render with list-style-position: outside, causing bullets to hang outside the bounding box. If bullets are cut off by an ancestor with overflow: hidden, change list-style-position to inside or adjust the left padding on the <ul>.
  • Custom Strings Cut Off on Mobile: When using wide unicode characters or emojis as string markers in list-style-type, ensure sufficient left padding (e.g., padding-inline-start: 2rem;) to avoid clipping along the viewport boundary.
  • List Items Missing Bullets Entirely: If list markers fail to appear despite valid list-style-type declarations, check whether a CSS reset applied list-style: none, or whether display: block or display: flex was applied to the <li>, which strips the native list-item counter box.

Get the best tech tips delivered straight to your inbox.

Join thousands of readers mastering Apple, Google, Microsoft, and Linux.