Create and Manage Pinned App Shortcuts on Android

Why Pinned App Shortcuts Matter

Android’s App Shortcuts let you jump directly to a specific function inside an app—think composing a new email, opening a favorite chat, or starting navigation to a saved address. By pinning these shortcuts to the home screen you get one‑tap access without opening the full app first. This not only saves time but also reduces battery use because the system doesn’t need to load the whole UI.

There are two ways to create shortcuts:

• Via the built‑in UI – works on most stock Android and many OEM skins.
• Via ADB (Android Debug Bridge) – useful when an app doesn’t expose a shortcut in the UI or when you want to script multiple shortcuts at once.

This tutorial covers both approaches, explains the underlying concepts, and provides troubleshooting tips for common pitfalls.

Before You Start

• Make sure your device is charged to at least 50 % or plugged into power.
• Connect to a stable Wi‑Fi network if you plan to use ADB over Wi‑Fi.
• Enable Developer options (Settings ▶ About phone ▶ Tap “Build number” seven times).
• In Developer options, turn on USB debugging. If you’ll use wireless ADB, also enable Wireless debugging (Android 12+).
• Install the adb command‑line tool on your computer. The official Android SDK Platform‑Tools package works on Windows, macOS, and Linux.

Part 1 – Adding Shortcuts Using the Android UI

Step 1: Locate an App Shortcut

If the shortcut appears, you can now pin it to the home screen.

Step 2: Pin the Shortcut

On some OEM skins (e.g., Samsung One UI), the long‑press menu may include a direct “Add shortcut to Home screen” option, skipping the extra drag step.

Step 3: Rename or Remove a Shortcut

Android does not provide a universal UI for renaming shortcuts. However, many launchers (Nova, Lawnchair, etc.) let you edit the label:

To remove a shortcut, drag it to the Remove or Trash area that appears at the top or bottom of the screen.

Part 2 – Creating Shortcuts with ADB

Some apps expose shortcuts only through code, or you may want to create shortcuts for actions that the UI does not surface (e.g., opening a specific Settings page). ADB lets you create Intent‑based shortcuts directly.

Understanding the Shortcut Command

The adb shell cmd shortcut command interacts with the system’s ShortcutManager. The basic syntax is:

adb shell cmd shortcut add <shortcut-id> <package-name> <activity-name> --label "<display‑name>" [--icon <resource-uri>] [--intent <intent-uri>]

Where:

• <shortcut-id> – a unique string you choose (e.g., gmail_compose).
• <package-name> – the app’s package (e.g., com.google.android.gm).
• <activity-name> – the activity that will handle the intent (often the main activity).
• --label – the text shown on the home screen.
• --icon – optional URI to a custom icon; if omitted the system uses the app’s default icon.
• --intent – a full intent URI describing the action (e.g., android.intent.action.VIEW with extras).

Step 1: Identify Package and Activity

Step 2: Build the Intent URI

For Gmail’s compose action, the intent looks like:

intent:#Intent;action=android.intent.action.SENDTO;data=mailto:?subject=;end

Explanation:

• action=android.intent.action.SENDTO tells Android to open a compose window.
• data=mailto:?subject= sets the scheme to mailto with an empty subject (you can pre‑fill if desired).

Step 3: Add the Shortcut

Tip: Use the --icon flag to supply a custom PNG stored in /sdcard/. Example:

--icon "file:///sdcard/shortcut_icon.png"

Step 4: Verify the Shortcut Works

Tap the newly placed shortcut. It should open the Gmail compose screen directly. If it opens the regular inbox, double‑check the intent URI and activity name.

Advanced Use Cases

• Shortcut to a Settings page: You can open any Settings sub‑screen using the android.settings.* actions. Example to open Wi‑Fi settings:

  adb shell cmd shortcut add wifi_settings com.android.settings com.android.settings.Settings$WifiSettingsActivity \
    --label "Wi‑Fi Settings" \
    --intent "intent:#Intent;action=android.settings.WIFI_SETTINGS;end"

• Batch creation: Place multiple adb shell cmd shortcut add … lines in a .sh script and run it once to populate a suite of shortcuts (e.g., for a work profile).
• Removing a shortcut:

  adb shell cmd shortcut delete gmail_compose

Troubleshooting

Shortcut Does Not Appear in the App Drawer

• Ensure the --intent URI is well‑formed. A missing ; or typo will cause the system to reject the shortcut.
• Check the app’s android:exported flag. If the target activity is not exported, the system cannot launch it from a shortcut.
• Run adb shell dumpsys shortcut to view all registered shortcuts and any error messages.

Custom Icon Not Showing

• The icon file must be a PNG under 96 × 96 dp (density‑independent pixels). Larger files are scaled down but may appear blurry.
• File path must use the file:// scheme and be readable by the system (store it in /sdcard/ or /data/local/tmp/).

Shortcut Gets Removed After Reboot

Shortcuts created via ADB are persisted, but some OEM launchers clean up unknown shortcuts on a fresh boot. If this happens:

1. Re‑add the shortcut after reboot.
2. Consider using a third‑party launcher that respects custom shortcuts (e.g., Nova Launcher).

Best Practices for a Clean Home Screen

• Group related shortcuts into folders (e.g., all communication shortcuts together).
• Use concise labels; long names wrap and waste space.
• Periodically review shortcuts—if an app updates and removes a function, the shortcut may become dead‑link.

Summary

Pinned app shortcuts are a low‑effort way to streamline daily Android tasks. By using the built‑in UI you can quickly add shortcuts for any app that already exposes them. When the UI falls short, ADB gives you fine‑grained control to create custom shortcuts for any activity or Settings page, even scripting them for multiple devices. Follow the preparation steps, use the command syntax carefully, and keep an eye on the troubleshooting tips to ensure your shortcuts stay functional and tidy.