references/extensions/context-menus.md
GitHubContext Menus
Setup
{ "permissions": ["contextMenus"] }
Creating Menus
Create in the service worker, typically in onInstalled (menus persist, but re-creating is idempotent):
chrome.runtime.onInstalled.addListener(() => {
chrome.contextMenus.create({
id: 'save-link',
title: 'Save to Reading List',
contexts: ['link'] // Only show on right-click of links
});
chrome.contextMenus.create({
id: 'translate-selection',
title: 'Translate "%s"', // %s = selected text
contexts: ['selection']
});
// M150+: Context menu for the tab strip (right-clicking a tab)
chrome.contextMenus.create({
id: 'duplicate-tab',
title: 'Custom Duplicate Tab',
contexts: ['tab']
});
});
Handling Clicks
chrome.contextMenus.onClicked.addListener((info, tab) => {
switch (info.menuItemId) {
case 'save-link':
saveLink(info.linkUrl, info.selectionText || info.linkUrl);
break;
case 'translate-selection':
translateText(info.selectionText, tab.id);
break;
case 'duplicate-tab':
chrome.tabs.duplicate(tab.id); // 'tab' parameter is the clicked tab
break;
}
});
Context Types
all, page, frame, selection, link, editable, image, video, audio, launcher, browser_action, action, tab (M150+)
Submenus
chrome.contextMenus.create({ id: 'parent', title: 'My Extension', contexts: ['page'] });
chrome.contextMenus.create({ id: 'child1', parentId: 'parent', title: 'Option 1', contexts: ['page'] });
chrome.contextMenus.create({ id: 'child2', parentId: 'parent', title: 'Option 2', contexts: ['page'] });
Dynamic Updates
chrome.contextMenus.update('save-link', { title: 'New Title' });
chrome.contextMenus.remove('save-link');
chrome.contextMenus.removeAll();