InDesign2026
API 21.5.1.73
Object

GeneralPreference

General application preferences.

Preference GeneralPreference
Hierarchy

Application

GeneralPreference

Properties

NameType AccessDescription
Boolean read/write If true, alt text for images are appended with generated by AI tag.
Boolean readonly If true, application bar is shown.
Boolean read/write If true, on creating new char style through the new char style dialog, it will be exported to CC Libraries as well
Boolean read/write If true, on creating new para style through the new para style dialog, it will be exported to CC Libraries as well
Boolean read/write If true, on creating new swatch through the new swatch dialog, it will be exported to CC Libraries as well
Boolean read/write If true, panel drawers close automatically.
Boolean read/write If true, alt text for images are auto generated when imported.
Boolean read/write If true, vertical reveal strips appear when palette UI is hidden.
Number read/write The threshold at which to trigger font subsetting based on the number of glyphs the font contains.
Boolean read/write Controls whether or not the context bar (contextual task bar) is visible.
Boolean read/write Enable the creation of links on content place
Number read/write When using a custom monitor resolution, what is the value of that resolution in pixels per inch
Boolean read/write If true, enable content-aware fit as default while placing items
Boolean read/write If true, floating windows can be docked by user as tabs.
Boolean read/write Controls whether or not multi-touch gestures are enabled.
EventListeners<EventListener> readonly A collection of event listeners.
Events<Event> readonly A collection of events.
Boolean read/write Controls whether or not to greek vector graphics when dragging at high quality.
Boolean read/write Controls whether or not to highlight object under selection tool.
Boolean read/write If true, includes a preview in saved documents.
Boolean readonly Returns true if the object specifier resolves to valid objects.
String read/write keyboard shortcut set
Number readonly The value of the system reported main monitor resolution
Boolean read/write Enable the mapping of styles on content place
Boolean read/write Controls whether page items move when a page is repositioned from the UI. The option/alt key temporarily reverses this property
Boolean read/write If true, documents open as tabs.
Number 0–30 read/write Number of items to show in the Open Recent menu list. Range: 0 to 30
PageNumberingOptions
read/write The page numbering method.
Boolean read/write If true, Large Tabs are shown for panels else Smaller tabs are shown
Application readonly The parent of the GeneralPreference (a Application).
Number read/write Specify the Pasteboard color preference (0 or 1). Specify 0 to set preference to Default White, and 1 to set preference to Match with Theme Color.
Boolean read/write Controls whether or not to show thumbnails of imported files in the Place icon.
Boolean read/write Controls whether or not you can select and interact with a locked item. When this is off, only position is locked.
PreviewPagesOptions
read/write The pages to create preview images for. Note: Valid when include preview is true.
PreviewSizeOptions
read/write The preview size. Note: Valid when include preview is true.
Object read/write A property that allows setting of several properties at the same time.
String read/write set active workspace
Boolean read/write Controls whether or not the anchor object adornment is shown.
Boolean read/write Controls whether or not the content grabber adornment is shown.
Boolean read/write Show the conveyor on content collector or content placer tool activation
Boolean read/write If true, legacy new document dialog will be shown when Ctrl/Cmd + N are pressed.
Boolean read/write Controls whether or not the live corners grabber adornment is shown.
Boolean read/write Controls whether or not to show the master page overlay when a page is selected using the Page Tool.
Boolean read/write If true, show start workspace when no documents are open
Boolean read/write If true, show stock cart adornment on unlicensed stock images
Boolean read/write Controls whether or not to dynamically display transformation information as part of the cursor while manipulating page items.
Boolean read/write If true, show What's New dialog on startup.
File read/write The location in which to store temporary files.
ToolTipOptions
read/write Tool tip behavior.
ToolsPanelOptions
read/write Controls the appearance of the Tools panel.
Number read/write Specify the Application User Interface brightness preference (from 0.0 to 1.0). To use color theme brightness preset values, specify 0.0 for Dark, 0.50 for Medium Dark, 0.51 for Medium Bright, and 1.0 for Bright. Any value between 0.0 and 1.0 will automatically be mapped to closest preset.
Boolean read/write If true, objects after ungrouping go back to their original layers.
Boolean readonly If true, application lives in a frame.
Boolean read/write Enable the use of a custom monitor resolution in pixels per inch as opposed to querying the system settings
Boolean read/write If true, use incoming spot color definition in case of conflict, when placing or pasting content

Methods

EventListener

Adds an event listener.

eventType String The event type.
handler File | JavaScriptFunction The event handler. Can accept: File or JavaScript Function.
captures? Boolean This parameter is obsolete.
GeneralPreference[]

Resolves the object specifier, creating an array of object references.

Boolean

Removes the event listener.

eventType String The registered event type.
handler File | JavaScriptFunction The registered event handler. Can accept: File or JavaScript Function.
captures? Boolean This parameter is obsolete.
String

Generates a string which, if executed, will return the GeneralPreference.

String

Retrieves the object specifier.

Object of 4

Properties elsewhere that hold a GeneralPreference.

Return 1

Methods that return a GeneralPreference.