Ubuntu Dock Customization Guide

By Kokil Thapa | Last reviewed: September 2026

A cluttered or misaligned dock slows daily work on any Ubuntu workstation. This Ubuntu Dock customization guide walks you through the built-in Settings panel, gsettings keys, and optional extensions that power the dock on modern GNOME desktops. Whether you run Ubuntu on a laptop in Kathmandu or a VPS you SSH into after local development, the dock is the first UI element you touch dozens of times per day. The steps below apply to Ubuntu 24.04 LTS and 22.04 LTS with GNOME Shell; server installs without a desktop environment are out of scope. For broader desktop context, see the Ubuntu GNOME desktop explained article first.

What is the Ubuntu Dock and how does it work on GNOME?

The Ubuntu Dock is not a separate application. It is a packaged GNOME Shell extension based on Dash to Dock, pre-enabled on Ubuntu desktop editions. GNOME Shell draws the top bar, overview, and workspace switcher. The dock extension renders your pinned and running app icons along one screen edge.

Understanding that split matters when something breaks after an upgrade. Settings changes write to dconf keys. Extension updates can reset or override those keys. A broader Ubuntu desktop customization workflow treats the dock as one layer in a stack that also includes themes, fonts, and keyboard shortcuts.

Pinned applications are stored separately from dock appearance. The favorites list uses the schema org.gnome.shell and key favorite-apps. Dock position, icon size, and panel mode use org.gnome.shell.extensions.dash-to-dock. I have seen upgrades merge these schemas differently between 22.04 and 24.04, so always verify keys with gsettings list-recursively after a release upgrade.

Default behavior you should know

• Left-edge dock with intelligently hidden mode on laptops.
• Running apps show a dot indicator; pinned apps stay visible.
• Right-click an icon for app actions, quit, or pin/unpin.
• Drag icons to reorder; drag from overview to pin new apps.
• Trash appears at the bottom unless disabled in Settings.

Developers who split time between a local Ubuntu laptop and remote servers still benefit from a tuned dock. Fast app switching pairs well with the shortcuts in the essential Ubuntu keyboard shortcuts reference.

How do you change Ubuntu Dock position and size in Settings?

The fastest path in this Ubuntu Dock customization guide is the GUI. Open Settings, then Ubuntu Desktop, then Dock. Ubuntu 24.04 groups these options clearly; 22.04 places them under Settings → Appearance → Dock.

1. Open Settings from the top-right system menu or press Super and type “Settings”.
2. Navigate to Ubuntu Desktop → Dock (or Appearance → Dock on 22.04).
3. Set Position on screen to Left, Bottom, or Right.
4. Adjust Icon size with the slider — typical values are 32–48 px.
5. Toggle Auto-hide the dock and choose hide behavior.
6. Enable or disable Show on all displays if you use multiple monitors.
7. Toggle Show trash icon and Mount icons for removable drives.

Panel mode is the single most impactful visual change. In Settings, enable Extend height or Panel mode wording depending on version. Panel mode stretches the dock background full height on vertical edges. Intelligently hide keeps the dock visible until a window overlaps it.

For a full desktop walkthrough beyond the dock alone, the Ubuntu desktop complete guide covers themes, fractional scaling, and workspace layout.

How do you customize the Ubuntu Dock with gsettings commands?

GUI settings map directly to dconf keys. Terminal control is reproducible across machines, scriptable for onboarding, and easy to document in internal runbooks. I use this approach when provisioning developer laptops for client teams alongside Linux system administration work.

First, confirm the schema exists:

gsettings list-schemas | grep dash-to-dock
gsettings list-keys org.gnome.shell.extensions.dash-to-dock

Common customizations with immediate effect:

# Move dock to bottom
gsettings set org.gnome.shell.extensions.dash-to-dock dock-position BOTTOM

# Icon size (pixels)
gsettings set org.gnome.shell.extensions.dash-to-dock dash-max-icon-size 40

# Always show dock (disable auto-hide)
gsettings set org.gnome.shell.extensions.dash-to-dock dock-fixed true
gsettings set org.gnome.shell.extensions.dash-to-dock autohide false

# Intellihide: hide when window would overlap
gsettings set org.gnome.shell.extensions.dash-to-dock intellihide true
gsettings set org.gnome.shell.extensions.dash-to-dock intellihide-mode 'FOCUS_APPLICATION_WINDOWS'

# Panel mode on left edge (stretch full height)
gsettings set org.gnome.shell.extensions.dash-to-dock extend-height true

# Shrink dock padding
gsettings set org.gnome.shell.extensions.dash-to-dock dash-edge-distance 8

# Show running indicators as dots
gsettings set org.gnome.shell.extensions.dash-to-dock running-dots true

Manage pinned apps programmatically:

# List current favorites
gsettings get org.gnome.shell favorite-apps

# Set favorites (example — adjust .desktop names)
gsettings set org.gnome.shell favorite-apps "['firefox.desktop', 'org.gnome.Terminal.desktop', 'code.desktop']"

Export and import dock settings for backup or migration:

dconf dump /org/gnome/shell/extensions/dash-to-dock/ > ~/dock-settings.dconf
dconf load /org/gnome/shell/extensions/dash-to-dock/ < ~/dock-settings.dconf

After changing extension-backed keys, restart GNOME Shell so the dock redraws. On X11 sessions, press Alt+F2, type r, and press Enter. On Wayland — the default on Ubuntu 24.04 — log out and back in. Wayland does not support hot restart.

Store your favorite gsettings one-liners in shell aliases. The Ubuntu command aliases guide shows how to keep them portable across machines.

Which GNOME extensions go beyond the default Ubuntu Dock?

Ubuntu ships a frozen Dash to Dock fork. Power users often install the upstream Dash to Dock extension or complementary tools for finer control. Enable extensions through the Extension Manager app or the browser plugin at extensions.gnome.org.

If you install upstream Dash to Dock, disable the Ubuntu Dock extension first. Two dock extensions fighting for the same screen edge produce duplicate icons or broken autohide. Open Extension Manager, toggle Ubuntu Dock off, then enable Dash to Dock.

Notable upstream Dash to Dock options exposed in its GUI:

• Click behavior: minimize, cycle windows, or launch new window.
• Shift dock away from monitor edge by a configurable margin.
• Customize background opacity and custom theme colors.
• Multi-monitor: dock on primary only, or per-monitor docks.
• Scroll on dock to switch workspaces.

Dash to Panel merges the top bar and dock into one bottom panel. It suits users coming from Windows or macOS menu-bar workflows. It is heavier and changes more GNOME Shell behavior than dock-only tweaks.

Official extension documentation lives in the GSettings desktop schemas documentation. Cross-check any key name there when a blog post references an outdated schema from an older Ubuntu release.

Install Extension Manager on Ubuntu 24.04

sudo apt update
sudo apt install gnome-shell-extension-manager

Extension Manager lets you browse, enable, and configure extensions without a browser plugin. It is the cleanest path for developers who prefer apt over manual ZIP installs.

How do you tune Ubuntu Dock for multi-monitor and performance?

Multi-monitor setups expose dock edge cases. A dock pinned to the left on a laptop may jump to the wrong display when you connect HDMI at a co-working space in Kathmandu or a client office abroad.

# Show dock on all monitors
gsettings set org.gnome.shell.extensions.dash-to-dock multi-monitor true

# Or lock to primary only
gsettings set org.gnome.shell.extensions.dash-to-dock multi-monitor false
gsettings set org.gnome.shell.extensions.dash-to-dock preferred-monitor 0

Fractional scaling above 100% can blur dock icons on some GPU drivers. If icons look soft, try integer scaling (200%) or adjust icon size to an even pixel value like 48. Performance tuning overlaps with the speed up Ubuntu performance checklist — disable unused extensions beyond the dock.

On machines that also run local PHP or Node development stacks, a lean desktop leaves more RAM for Docker and MySQL. The dock itself is lightweight; it is the total extension count that adds up. Pair dock tweaks with the practices in install PHP on Ubuntu when your workstation doubles as a dev server.

How do you fix common Ubuntu Dock problems after updates?

Dock issues after apt upgrade usually trace to extension version mismatch, stale dconf keys, or a disabled extension. Work through these fixes in order.

Dock vanished entirely

1. Open Extension Manager and confirm Ubuntu Dock is enabled.
2. Run gnome-extensions list and check for a disabled ubuntu-dock entry.
3. Log out and back in — do not just lock the screen.
4. Reset dock settings: dconf reset -f /org/gnome/shell/extensions/dash-to-dock/

Duplicate icons or two docks

Two dash extensions are enabled. Disable either Ubuntu Dock or upstream Dash to Dock. Only one should remain active.

Icons wrong size or theme mismatch

Icon size keys may conflict with desktop zoom. Reset icon size in Settings, then reapply gsettings values. GNOME icon themes come from org.gnome.desktop.interface key icon-theme, not the dock schema.

Autohide flickers or dock will not hide

gsettings set org.gnome.shell.extensions.dash-to-dock autohide true
gsettings set org.gnome.shell.extensions.dash-to-dock dock-fixed false
gsettings set org.gnome.shell.extensions.dash-to-dock intellihide true

If flicker persists, disable intellihide and use manual autohide only. Some fractional-scaling setups trigger false overlap detection.

Production servers I maintain on Ubuntu — including sister legal-tech sites deployed with GitLab CI — never run a dock. The same gsettings discipline applies to server config documented in the Ubuntu server setup guide and the Notary Kathmandu portfolio case. Desktop and server share one dconf mindset: change, verify, backup.

For security-conscious workstations, dock visibility is minor compared to firewall and update policy. Harden the base OS using the Ubuntu security hardening guide and UFW firewall configuration before spending hours on cosmetic tweaks.

Reset everything to factory defaults

dconf reset -f /org/gnome/shell/extensions/dash-to-dock/
dconf reset -f /org/gnome/shell/
# Log out and back in

Back up first with dconf dump as shown earlier. A reset clears pinned apps in favorite-apps as well if you reset the parent /org/gnome/shell/ path.

When you need to validate JSON configs exported from dock-adjacent tooling, the JSON formatter on this site handles quick syntax checks. For terminal-heavy workflows, keep the essential Ubuntu terminal commands reference bookmarked.

Ubuntu’s official desktop documentation at Ubuntu Desktop documentation confirms Settings paths for current LTS releases. Use it when Canonical renames panels between versions.

Key Takeaways

• Ubuntu Dock is a Dash to Dock fork — its keys live under org.gnome.shell.extensions.dash-to-dock.
• Use Settings for quick changes; use gsettings when you need reproducible, scriptable setups.
• Disable Ubuntu Dock before enabling upstream Dash to Dock to avoid duplicate panels.
• Back up with dconf dump before major upgrades or resets.
• On Wayland, log out to apply shell changes — Alt+F2 restart only works on X11.
• Multi-monitor behavior is controlled by multi-monitor and preferred-monitor keys.

People Also Ask

Can you move the Ubuntu Dock to the bottom?

Yes. Open Settings → Ubuntu Desktop → Dock and set position to Bottom. From the terminal, run gsettings set org.gnome.shell.extensions.dash-to-dock dock-position BOTTOM. Log out on Wayland if the dock does not move immediately.

How do I hide the Ubuntu Dock completely?

Enable auto-hide in Settings, or set dock-fixed to false with autohide true via gsettings. To remove the dock entirely, disable the Ubuntu Dock extension in Extension Manager — you will rely on the Super overview to launch apps.

Why does my Ubuntu Dock look different after an upgrade?

Release upgrades often bump the Dash to Dock fork. New defaults may reset icon size or panel mode. Export settings before upgrading, then compare keys with gsettings list-recursively org.gnome.shell.extensions.dash-to-dock.

Is Dash to Dock the same as Ubuntu Dock?

Ubuntu Dock is Canonical’s patched, pre-enabled fork of Dash to Dock. Upstream Dash to Dock receives features first but must be installed manually and requires disabling Ubuntu Dock to prevent conflicts.

Build a productive Ubuntu workstation

A well-tuned dock saves seconds on every app switch. Those seconds compound across years of development work. This Ubuntu Dock customization guide gives you three layers — Settings, gsettings, and extensions — so you can match the dock to your monitor layout and workflow. Start with Settings, script the rest, and back up dconf before every LTS upgrade.

If your team needs standardized developer machines, server hardening, or deployment pipelines alongside desktop setup, see support and maintenance services or deploy Laravel on Ubuntu VPS with Nginx. For hands-on help provisioning Ubuntu desktops and servers, contact us with your environment details.