sets the specified default options for a symbol s.

SetOptions[stream,] or SetOptions["name",]

sets options associated with a particular stream.


sets options associated with an external object such as a NotebookObject or CloudObject.



open allclose all

Basic Examples  (1)

Change the style for plots to dashed curves:

Restore the system default:

Scope  (4)

Reset the default precision for HilbertMatrix:

Now HilbertMatrix uses machine numbers by default:

A specific option setting overrides the new default:

Restore the system default:

Start writing to a temporary file:

Set the page width to 10 characters:

Write Range[10] to the file and close the stream:

Line breaks occur at the 10th column:

Create a reference to the input cell:

Change the background of the cell to red:

Restore the setting of the cell, which will cause it to inherit from the notebook:

Change the Permissions of a CloudObject:

Properties & Relations  (2)

SetOptions can be used to modify protected symbols:

The option has been modified:

The symbol still has attribute Protected:

Restore the system default:

SetOptions resets the Permissions value entirely (except for the owner's permissions):

SetPermissions only resets the capabilities of the given user groups:

Possible Issues  (2)

SetOptions can only be used to change the default value of an option, not to add a new one:

Use AppendTo, PrependTo and similar functions to add additional options to a function:

For notebook options with rules, it can be awkward to make a targeted change to a specific rule:

CurrentValue provides a better way of adding or changing specific rules:

Wolfram Research (1988), SetOptions, Wolfram Language function, (updated 2012).


Wolfram Research (1988), SetOptions, Wolfram Language function, (updated 2012).


Wolfram Language. 1988. "SetOptions." Wolfram Language & System Documentation Center. Wolfram Research. Last Modified 2012.


Wolfram Language. (1988). SetOptions. Wolfram Language & System Documentation Center. Retrieved from


@misc{reference.wolfram_2024_setoptions, author="Wolfram Research", title="{SetOptions}", year="2012", howpublished="\url{}", note=[Accessed: 30-May-2024 ]}


@online{reference.wolfram_2024_setoptions, organization={Wolfram Research}, title={SetOptions}, year={2012}, url={}, note=[Accessed: 30-May-2024 ]}