Firefox 3rdparty Policy support

[lomenzel]

Hey there,
does TST support configuration via the Firefox policies?

https://extensionworkshop.com/documentation/enterprise/enterprise-development/#how-to-add-policy

[piroor]

Yes, TST (and other my Firefox addons) supports configuring via GPO and policies.json.
Here is the complete list of configurable options:

treestyletab/webextensions/common/common.js

Lines 129 to 591 in 02abdd1

	optionsExpandedSections: [
	'section-appearance',
	'section-addons',
	'section-advanced',
	'section-drag',
	'section-treeBehavior',
	'section-newTab',
	'section-newTabWithOwner',
	'section-contextMenu',
	],
	optionsExpandedGroups: [],
	// appearance
	sidebarPosition: Constants.kTABBAR_POSITION_AUTO,
	sidebarPositionRighsideNotificationShown: false,
	sidebarPositionOptionNotificationTimeout: 20 * 1000,
	style: /^Mac/i.test(navigator.platform) ? 'sidebar' : 'proton',
	colorScheme: /^Linux/i.test(navigator.platform) ? 'system-color' : 'photon' ,
	iconColor: 'auto',
	indentLine: 'auto',
	shiftTabsForScrollbarDistance: '0.5em',
	shiftTabsForScrollbarOnlyOnHover: false,
	unrepeatableBGImageAspectRatio: 4,
	faviconizePinnedTabs: true,
	maxFaviconizedPinnedTabsInOneRow: 0, // auto
	faviconizedTabScale: 1.75,
	maxPinnedTabsRowsAreaPercentage: 50,
	counterRole: Constants.kCOUNTER_ROLE_CONTAINED_TABS,
	baseIndent: 12,
	minIndent: Constants.kDEFAULT_MIN_INDENT,
	maxTreeLevel: -1,
	indentAutoShrink: true,
	indentAutoShrinkOnlyForVisible: true,
	labelOverflowStyle: 'fade',
	showContextualIdentitiesSelector: false,
	showNewTabActionSelector: true,
	longPressOnNewTabButton: Constants.kCONTEXTUAL_IDENTITY_SELECTOR,
	zoomable: false,
	showOverflowTitleByTooltip: true,
	showCollapsedDescendantsByTooltip: true,
	showDialogInSidebar: false,
	outOfScreenTabsRenderingPages: 1,
	renderHiddenTabs: false,
	suppressGapFromShownOrHiddenToolbarOnlyOnMouseOperation: true,
	suppressGapFromShownOrHiddenToolbarOnFullScreen: false,
	suppressGapFromShownOrHiddenToolbarOnNewTab: true,
	suppressGapFromShownOrHiddenToolbarInterval: 50,
	suppressGapFromShownOrHiddenToolbarTimeout: 500,
	cancelGapSuppresserHoverDelay: 1000, // msec
	enableWorkaroundForBug1875100: true,
	watchWindowStateInterval: 500,
	// context menu
	emulateDefaultContextMenu: true,
	showTreeCommandsInTabsContextMenuGlobally: true,
	context_reloadTree: true,
	context_reloadDescendants: false,
	context_unblockAutoplayTree: true,
	context_unblockAutoplayDescendants: false,
	context_toggleMuteTree: true,
	context_toggleMuteDescendants: false,
	context_closeTree: true,
	context_closeDescendants: false,
	context_closeOthers: false,
	context_toggleSticky: false,
	context_collapseTree: false,
	context_collapseTreeRecursively: true,
	context_collapseAll: true,
	context_expandTree: false,
	context_expandTreeRecursively: true,
	context_expandAll: true,
	context_bookmarkTree: true,
	context_sendTreeToDevice: false,
	context_topLevel_reloadTree: false,
	context_topLevel_reloadDescendants: false,
	context_topLevel_unblockAutoplayTree: false,
	context_topLevel_unblockAutoplayDescendants: false,
	context_topLevel_toggleMuteTree: false,
	context_topLevel_toggleMuteDescendants: false,
	context_topLevel_closeTree: false,
	context_topLevel_closeDescendants: false,
	context_topLevel_closeOthers: false,
	context_topLevel_toggleSticky: true,
	context_topLevel_collapseTree: false,
	context_topLevel_collapseTreeRecursively: false,
	context_topLevel_collapseAll: false,
	context_topLevel_expandTree: false,
	context_topLevel_expandTreeRecursively: false,
	context_topLevel_expandAll: false,
	context_topLevel_bookmarkTree: false,
	context_topLevel_sendTreeToDevice: true,
	context_collapsed: false,
	context_pinnedTab: false,
	context_unpinnedTab: false,
	context_openAllBookmarksWithStructure: true,
	context_openAllBookmarksWithStructureRecursively: false,
	openAllBookmarksWithStructureDiscarded: true,
	suppressGroupTabForStructuredTabsFromBookmarks: true,
	// tree behavior
	shouldDetectClickOnIndentSpaces: true,
	autoCollapseExpandSubtreeOnAttach: true,
	autoCollapseExpandSubtreeOnSelect: true,
	autoCollapseExpandSubtreeOnSelectExceptActiveTabRemove: true,
	treeDoubleClickBehavior: Constants.kTREE_DOUBLE_CLICK_BEHAVIOR_NONE,
	autoExpandIntelligently: true,
	unfocusableCollapsedTab: true,
	autoExpandOnTabSwitchingShortcuts: true,
	autoExpandOnTabSwitchingShortcutsDelay: 800,
	autoExpandOnLongHover: true,
	autoExpandOnLongHoverDelay: 500,
	autoExpandOnLongHoverRestoreIniitalState: true,
	accelKey: '',
	skipCollapsedTabsForTabSwitchingShortcuts: false,
	syncParentTabAndOpenerTab: true,
	dropLinksOnTabBehavior: Constants.kDROPLINK_ASK,
	tabDragBehavior: Constants.kDRAG_BEHAVIOR_MOVE | Constants.kDRAG_BEHAVIOR_TEAR_OFF | Constants.kDRAG_BEHAVIOR_ENTIRE_TREE,
	tabDragBehaviorShift: Constants.kDRAG_BEHAVIOR_MOVE | Constants.kDRAG_BEHAVIOR_ENTIRE_TREE | Constants.kDRAG_BEHAVIOR_ALLOW_BOOKMARK,
	showTabDragBehaviorNotification: true,
	guessDraggedNativeTabs: true,
	ignoreTabDropNearSidebarArea: true,
	moveSoloTabOnDropParentToDescendant: true,
	fixupTreeOnTabVisibilityChanged: false,
	fixupOrderOfTabsFromOtherDevice: true,
	scrollToExpandedTree: true,
	syncActiveStateToBundledTabs: true,
	spreadMutedStateOnlyToSoundPlayingTabs: true,
	// tab bunches
	tabBunchesDetectionTimeout: 100,
	tabBunchesDetectionDelayOnNewWindow: 500,
	autoGroupNewTabsFromBookmarks: true,
	restoreTreeForTabsFromBookmarks: true,
	tabsFromSameFolderMinThresholdPercentage: 50,
	autoGroupNewTabsFromOthers: false,
	autoGroupNewTabsFromPinned: true,
	autoGroupNewTabsFromFirefoxView: false,
	groupTabTemporaryStateForNewTabsFromBookmarks: Constants.kGROUP_TAB_TEMPORARY_STATE_PASSIVE,
	groupTabTemporaryStateForNewTabsFromOthers: Constants.kGROUP_TAB_TEMPORARY_STATE_PASSIVE,
	groupTabTemporaryStateForChildrenOfPinned: Constants.kGROUP_TAB_TEMPORARY_STATE_PASSIVE,
	groupTabTemporaryStateForChildrenOfFirefoxView: Constants.kGROUP_TAB_TEMPORARY_STATE_PASSIVE,
	groupTabTemporaryStateForOrphanedTabs: Constants.kGROUP_TAB_TEMPORARY_STATE_AGGRESSIVE,
	renderTreeInGroupTabs: true,
	warnOnAutoGroupNewTabs: true,
	warnOnAutoGroupNewTabsWithListing: true,
	warnOnAutoGroupNewTabsWithListingMaxRows: 5,
	showAutoGroupOptionHint: true,
	// behavior around newly opened tabs
	insertNewChildAt: Constants.kINSERT_END, // basically this option affects only very edge cases not controlled with "autoAttach*" options.
	insertNewTabFromPinnedTabAt: Constants.kINSERT_NEXT_TO_LAST_RELATED_TAB,
	insertNewTabFromFirefoxViewAt: Constants.kINSERT_NEXT_TO_LAST_RELATED_TAB,
	insertDroppedTabsAt: Constants.kINSERT_END,
	scrollToNewTabMode: Constants.kSCROLL_TO_NEW_TAB_IF_POSSIBLE,
	scrollLines: 3,
	autoAttach: true,
	autoAttachOnOpenedWithOwner: Constants.kNEWTAB_OPEN_AS_CHILD_END,
	autoAttachOnNewTabCommand: Constants.kNEWTAB_DO_NOTHING,
	autoAttachOnContextNewTabCommand: Constants.kNEWTAB_OPEN_AS_NEXT_SIBLING_WITH_INHERITED_CONTAINER,
	autoAttachOnNewTabButtonMiddleClick: Constants.kNEWTAB_OPEN_AS_CHILD_END,
	middleClickPasteURLOnNewTabButton: /^Linux/i.test(navigator.platform), // simulates "browser.tabs.searchclipboardfor.middleclick"
	autoAttachOnNewTabButtonAccelClick: Constants.kNEWTAB_OPEN_AS_NEXT_SIBLING_WITH_INHERITED_CONTAINER,
	autoAttachOnDuplicated: Constants.kNEWTAB_OPEN_AS_NEXT_SIBLING,
	autoAttachSameSiteOrphan: Constants.kNEWTAB_OPEN_AS_CHILD_END,
	autoAttachOnOpenedFromExternal: Constants.kNEWTAB_DO_NOTHING,
	autoAttachOnAnyOtherTrigger: Constants.kNEWTAB_DO_NOTHING,
	guessNewOrphanTabAsOpenedByNewTabCommand: true,
	guessNewOrphanTabAsOpenedByNewTabCommandTitle: browser.i18n.getMessage('guessNewOrphanTabAsOpenedByNewTabCommandTitle'),
	guessNewOrphanTabAsOpenedByNewTabCommandUrl: 'about:newtab|about:privatebrowsing',
	inheritContextualIdentityToChildTabMode: Constants.kCONTEXTUAL_IDENTITY_DEFAULT,
	inheritContextualIdentityToSameSiteOrphanMode: Constants.kCONTEXTUAL_IDENTITY_FROM_LAST_ACTIVE,
	inheritContextualIdentityToTabsFromExternalMode: Constants.kCONTEXTUAL_IDENTITY_DEFAULT,
	inheritContextualIdentityToTabsFromAnyOtherTriggerMode: Constants.kCONTEXTUAL_IDENTITY_DEFAULT,
	inheritContextualIdentityToUnopenableURLTabs: false,
	// behavior around closed tab
	parentTabOperationBehaviorMode: Constants.kPARENT_TAB_OPERATION_BEHAVIOR_MODE_PARALLEL,
	//closeParentBehavior_insideSidebar_collapsed: Constants.kPARENT_TAB_OPERATION_BEHAVIOR_ENTIRE_TREE, // permanently consistent
	closeParentBehavior_insideSidebar_expanded: Constants.kPARENT_TAB_OPERATION_BEHAVIOR_PROMOTE_FIRST_CHILD,
	closeParentBehavior_outsideSidebar_collapsed: Constants.kPARENT_TAB_OPERATION_BEHAVIOR_PROMOTE_FIRST_CHILD,
	closeParentBehavior_outsideSidebar_expanded: Constants.kPARENT_TAB_OPERATION_BEHAVIOR_PROMOTE_FIRST_CHILD,
	closeParentBehavior_noSidebar_collapsed: Constants.kPARENT_TAB_OPERATION_BEHAVIOR_PROMOTE_FIRST_CHILD,
	closeParentBehavior_noSidebar_expanded: Constants.kPARENT_TAB_OPERATION_BEHAVIOR_PROMOTE_FIRST_CHILD,
	//moveParentBehavior_insideSidebar_collapsed: Constants.kPARENT_TAB_OPERATION_BEHAVIOR_ENTIRE_TREE, // permanently consistent
	//moveParentBehavior_insideSidebar_expanded: Constants.kPARENT_TAB_OPERATION_BEHAVIOR_ENTIRE_TREE, // permanently consistent
	moveParentBehavior_outsideSidebar_collapsed: Constants.kPARENT_TAB_OPERATION_BEHAVIOR_ENTIRE_TREE,
	moveParentBehavior_outsideSidebar_expanded: Constants.kPARENT_TAB_OPERATION_BEHAVIOR_PROMOTE_FIRST_CHILD,
	moveParentBehavior_noSidebar_collapsed: Constants.kPARENT_TAB_OPERATION_BEHAVIOR_PROMOTE_FIRST_CHILD,
	moveParentBehavior_noSidebar_expanded: Constants.kPARENT_TAB_OPERATION_BEHAVIOR_PROMOTE_FIRST_CHILD,
	moveTabsToBottomWhenDetachedFromClosedParent: false,
	promoteAllChildrenWhenClosedParentIsLastChild: true,
	successorTabControlLevel: Constants.kSUCCESSOR_TAB_CONTROL_IN_TREE,
	simulateSelectOwnerOnClose: true,
	simulateLockTabSizing: true,
	simulateTabsLoadInBackgroundInverted: false,
	supportTabsMultiselect: typeof browser.menus.overrideContext == 'function',
	warnOnCloseTabs: true,
	warnOnCloseTabsNotificationTimeout: 20 * 1000,
	warnOnCloseTabsByClosebox: true,
	warnOnCloseTabsWithListing: true,
	lastConfirmedToCloseTabs: 0,
	grantedRemovingTabIds: [],
	sidebarVirtuallyOpenedWindows: [], // for automated tests
	sidebarVirtuallyClosedWindows: [], // for automated tests
	sidebarWidthInWindow: {},
	// animation
	animation: true,
	animationForce: false,
	maxAllowedImmediateRefreshCount: 1,
	smoothScrollEnabled: true,
	smoothScrollDuration: 150,
	burstDuration: 375,
	indentDuration: 200,
	collapseDuration: 150,
	outOfViewTabNotifyDuration: 750,
	subMenuOpenDelay: 300,
	subMenuCloseDelay: 300,
	// subpanel
	lastSelectedSubPanelProviderId: null,
	lastSubPanelHeight: 0,
	maxSubPanelSizeRatio: 0.66,
	// misc.
	showExpertOptions: false,
	exposeUnblockAutoplayFeatures: false,
	bookmarkTreeFolderName: browser.i18n.getMessage('bookmarkFolder_label_default', ['%TITLE%', '%YEAR%', '%MONTH%', '%DATE%']),
	defaultBookmarkParentId: 'toolbar_____', // 'unfiled_____' for Firefox 83 and olders,
	incrementalSearchTimeout: 1000, // same to the default value of Firefox's "ui.menu.incremental_search.timeout"
	defaultSearchEngine: 'https://www.google.com/search?q=%s',
	acceleratedTabOperations: true,
	acceleratedTabCreation: false,
	enableWorkaroundForBug1409262: false,
	enableWorkaroundForBug1548949: true,
	enableWorkaroundForBug1767165_fixDragEndCoordinates: null, // workaround for https://bugzilla.mozilla.org/show_bug.cgi?id=1767165
	enableWorkaroundForBug1763420_reloadMaskImage: true, // workaround for https://bugzilla.mozilla.org/show_bug.cgi?id=1763420
	maximumDelayForBug1561879: 500,
	workaroundForBug1548949DroppedTabs: null,
	heartbeatInterval: 5000,
	connectionTimeoutDelay: 500,
	maximumAcceptableDelayForTabDuplication: 10 * 1000,
	maximumDelayUntilTabIsTracked: 10 * 60 * 1000,
	delayToBlockUserOperationForTabsRestoration: 1000,
	intervalToUpdateProgressForBlockedUserOperation: 50,
	delayToShowProgressForBlockedUserOperation: 1000,
	acceptableDelayForInternalFocusMoving: 150,
	delayForDuplicatedTabDetection: 0, // https://github.com/piroor/treestyletab/issues/2845
	delayToRetrySyncTabsOrder: 100,
	notificationTimeout: 10 * 1000,
	longPressDuration: 400,
	minimumIntervalToProcessDragoverEvent: 50,
	delayToApplyHighlightedState: 50,
	acceptableFlickerToIgnoreClickOnTabAndTabbar: 10,
	autoDiscardTabForUnexpectedFocus: true,
	autoDiscardTabForUnexpectedFocusDelay: 500,
	avoidDiscardedTabToBeActivatedIfPossible: false,
	provressiveHighlightingStep: Number.MAX_SAFE_INTEGER,
	progressievHighlightingInterval: 100,
	generatedTabElementsPoolLifetimeMsec: 5 * 1000,
	undoMultipleTabsClose: true,
	allowDragNewTabButton: true,
	newTabButtonDragGestureModifiers: 'shift',
	migratedBookmarkUrls: [],
	lastDragOverSidebarOwnerWindowId: null,
	notifiedFeaturesVersion: 0,
	useCachedTree: true,
	persistCachedTree: true,
	// This should be removed after https://bugzilla.mozilla.org/show_bug.cgi?id=1388193
	// or https://bugzilla.mozilla.org/show_bug.cgi?id=1421329 become fixed.
	// Otherwise you need to set "svg.context-properties.content.enabled"="true" via "about:config".
	simulateSVGContextFill: true,
	requestingPermissions: null,
	requestingPermissionsNatively: null,
	lastDraggedTabs: null,
	// https://dxr.mozilla.org/mozilla-central/rev/2535bad09d720e71a982f3f70dd6925f66ab8ec7/browser/base/content/browser.css#137
	newTabAnimationDuration: 100,
	chunkedUserStyleRules0: '',
	chunkedUserStyleRules1: '',
	chunkedUserStyleRules2: '',
	chunkedUserStyleRules3: '',
	chunkedUserStyleRules4: '',
	chunkedUserStyleRules5: '',
	chunkedUserStyleRules6: '',
	chunkedUserStyleRules7: '',
	// obsolete, migrated to chunkedUserStyleRules0-5
	userStyleRules: `
	/* Show title of unread tabs with red and italic font */
	/*
	:root.sidebar tab-item.unread .label-content {
	color: red !important;
	font-style: italic !important;
	}
	*/
	/* Add private browsing indicator per tab */
	/*
	:root.sidebar tab-item.private-browsing tab-label:before {
	content: "🕶";
	}
	*/
	`.trim(),
	userStyleRulesFieldHeight: '10em',
	userStyleRulesFieldTheme: 'auto',
	syncOtherDevicesDetected: false,
	syncAvailableNotified: false,
	syncAvailableNotificationTimeout: 20 * 1000,
	syncDeviceInfo: null,
	syncDevices: {},
	syncDevicesLocalCache: {},
	syncDeviceExpirationDays: 14,
	// Must be same to "services.sync.engine.tabs.filteredUrls"
	syncUnsendableUrlPattern: '^(about:.*|resource:.*|chrome:.*|wyciwyg:.*|file:.*|blob:.*|moz-extension:.*)$',
	syncLastMessageTimestamp: 0,
	syncReceivedTabsNotificationTimeout: 20 * 1000,
	syncSentTabsNotificationTimeout: 5 * 1000,
	chunkedSyncData0: '',
	chunkedSyncData1: '',
	chunkedSyncData2: '',
	chunkedSyncData3: '',
	chunkedSyncData4: '',
	chunkedSyncData5: '',
	chunkedSyncData6: '',
	chunkedSyncData7: '',
	chunkedSyncDataLocal0: '',
	chunkedSyncDataLocal1: '',
	chunkedSyncDataLocal2: '',
	chunkedSyncDataLocal3: '',
	chunkedSyncDataLocal4: '',
	chunkedSyncDataLocal5: '',
	chunkedSyncDataLocal6: '',
	chunkedSyncDataLocal7: '',
	// Compatibility with other addons
	knownExternalAddons: [
	'[email protected]'
	],
	cachedExternalAddons: [],
	grantedExternalAddonPermissions: {},
	incognitoAllowedExternalAddons: [],
	// This must be same to the redirect key of Container Bookmarks.
	// https://addons.mozilla.org/firefox/addon/container-bookmarks/
	containerRedirectKey: 'container',
	debug: false,
	runTestsParameters: '',
	syncEnabled: true,
	APIEnabled: true,
	cacheAPITreeItems: false,
	logTimestamp: true,
	loggingQueries: false,
	logFor: { // git grep configs.logFor | grep -v common.js | cut -d "'" -f 2 | sed -e "s/^/ '/" -e "s/$/': false,/"
	'background/api-tabs-listener': false,
	'background/background-cache': false,
	'background/background': false,
	'background/browser-action-menu': false,
	'background/commands': false,
	'background/context-menu': false,
	'background/handle-misc': false,
	'background/handle-moved-tabs': false,
	'background/handle-new-tabs': false,
	'background/handle-removed-tabs': false,
	'background/handle-tab-bunches': false,
	'background/handle-tab-focus': false,
	'background/handle-tab-multiselect': false,
	'background/handle-tree-changes': false,
	'background/migration': false,
	'background/successor-tab': false,
	'background/tab-context-menu': false,
	'background/tabs-group': false,
	'background/tabs-move': false,
	'background/tabs-open': false,
	'background/tree': false,
	'background/tree-structure': false,
	'common/Tab': false,
	'common/Window': false,
	'common/api-tabs': false,
	'common/bookmark': false,
	'common/contextual-identities': false,
	'common/dialog': false,
	'common/permissions': false,
	'common/retrieve-url': false,
	'common/sidebar-connection': false,
	'common/sync': false,
	'common/tabs-internal-operation': false,
	'common/tabs-update': false,
	'common/tree-behavior': false,
	'common/tst-api': false,
	'common/unique-id': false,
	'common/user-operation-blocker': false,
	'sidebar/background-connection': false,
	'sidebar/collapse-expand': false,
	'sidebar/drag-and-drop': false,
	'sidebar/event-utils': false,
	'sidebar/gap-canceller': false,
	'sidebar/indent': false,
	'sidebar/mouse-event-listener': false,
	'sidebar/pinned-tabs': false,
	'sidebar/scroll': false,
	'sidebar/sidebar-tabs': false,
	'sidebar/sidebar': false,
	'sidebar/size': false,
	'sidebar/subpanel': false,
	'sidebar/tab-context-menu': false,
	'sidebar/tst-api-frontend': false,
	},
	loggingConnectionMessages: false,
	enableLinuxBehaviors: false,
	enableMacOSBehaviors: false,
	enableWindowsBehaviors: false,
	...(Object.fromEntries(Array.from(obsoleteConfigs, key => [key, null]))),
	configsVersion: 0,
	testKey: 0 // for tests/utils.js

For example:

{
  "policies": {
    "3rdparty": {
      "Extensions": {
        "[email protected]": {
          "sidebarPosition": 1,
            "sidebarPosition:locked": false
        }
      }
    }
  }
}

I recommend you to configure TST by hand and export all options, then copy exported data and paste it under [email protected]. They are locked by default but you can allow users to change the option with setting "<name>:locked":false (so it means "changing the default value").