Products
  • Wolfram|One

    The definitive Wolfram Language and notebook experience

  • Mathematica

    The original technical computing environment

  • Notebook Assistant + LLM Kit

    All-in-one AI assistance for your Wolfram experience

  • Compute Services
  • System Modeler
  • Finance Platform
  • Wolfram|Alpha Notebook Edition
  • Application Server
  • Enterprise Private Cloud
  • Wolfram Engine
  • Wolfram Player
  • Wolfram Cloud App
  • Wolfram Player App

More mobile apps

Core Technologies of Wolfram Products

  • Wolfram Language
  • Computable Data
  • Wolfram Notebooks
  • AI & Linguistic Understanding

Deployment Options

  • Wolfram Cloud
  • wolframscript
  • Wolfram Engine Community Edition
  • Wolfram LLM API
  • WSTPServer
  • Wolfram|Alpha APIs

From the Community

  • Function Repository
  • Community Paclet Repository
  • Example Repository
  • Neural Net Repository
  • Prompt Repository
  • Wolfram Demonstrations
  • Data Repository
  • Group & Organizational Licensing
  • All Products
Consulting & Solutions

We deliver solutions for the AI era—combining symbolic computation, data-driven insights and deep technical expertise

  • Data & Computational Intelligence
  • Model-Based Design
  • Algorithm Development
  • Wolfram|Alpha for Business
  • Blockchain Technology
  • Education Technology
  • Quantum Computation

Wolfram Consulting

Wolfram Solutions

  • Data Science
  • Artificial Intelligence
  • Biosciences
  • Healthcare Intelligence
  • Sustainable Energy
  • Control Systems
  • Enterprise Wolfram|Alpha
  • Blockchain Labs

More Wolfram Solutions

Wolfram Solutions For Education

  • Research Universities
  • Colleges & Teaching Universities
  • Junior & Community Colleges
  • High Schools
  • Educational Technology
  • Computer-Based Math

More Solutions for Education

  • Contact Us
Learning & Support

Get Started

  • Wolfram Language Introduction
  • Fast Intro for Programmers
  • Fast Intro for Math Students
  • Wolfram Language Documentation

More Learning

  • Highlighted Core Areas
  • Demonstrations
  • YouTube
  • Daily Study Groups
  • Wolfram Schools and Programs
  • Books

Grow Your Skills

  • Wolfram U

    Courses in computing, science, life and more

  • Community

    Learn, solve problems and share ideas.

  • Blog

    News, views and insights from Wolfram

  • Resources for

    Software Developers

Tech Support

  • Contact Us
  • Support FAQs
  • Support FAQs
  • Contact Us
Company
  • About Wolfram
  • Career Center
  • All Sites & Resources
  • Connect & Follow
  • Contact Us

Work with Us

  • Student Ambassador Initiative
  • Wolfram for Startups
  • Student Opportunities
  • Jobs Using Wolfram Language

Educational Programs for Adults

  • Summer School
  • Winter School

Educational Programs for Youth

  • Middle School Camp
  • High School Research Program
  • Computational Adventures

Read

  • Stephen Wolfram's Writings
  • Wolfram Blog
  • Wolfram Tech | Books
  • Wolfram Media
  • Complex Systems

Educational Resources

  • Wolfram MathWorld
  • Wolfram in STEM/STEAM
  • Wolfram Challenges
  • Wolfram Problem Generator

Wolfram Initiatives

  • Wolfram Science
  • Wolfram Foundation
  • History of Mathematics Project

Events

  • Stephen Wolfram Livestreams
  • Online & In-Person Events
  • Contact Us
  • Connect & Follow
Wolfram|Alpha
  • Your Account
  • User Portal
  • Wolfram Cloud
  • Products
    • Wolfram|One
    • Mathematica
    • Notebook Assistant + LLM Kit
    • Compute Services
    • System Modeler
    • Finance Platform
    • Wolfram|Alpha Notebook Edition
    • Application Server
    • Enterprise Private Cloud
    • Wolfram Engine
    • Wolfram Player
    • Wolfram Cloud App
    • Wolfram Player App

    More mobile apps

    • Core Technologies
      • Wolfram Language
      • Computable Data
      • Wolfram Notebooks
      • AI & Linguistic Understanding
    • Deployment Options
      • Wolfram Cloud
      • wolframscript
      • Wolfram Engine Community Edition
      • Wolfram LLM API
      • WSTPServer
      • Wolfram|Alpha APIs
    • From the Community
      • Function Repository
      • Community Paclet Repository
      • Example Repository
      • Neural Net Repository
      • Prompt Repository
      • Wolfram Demonstrations
      • Data Repository
    • Group & Organizational Licensing
    • All Products
  • Consulting & Solutions

    We deliver solutions for the AI era—combining symbolic computation, data-driven insights and deep technical expertise

    WolframConsulting.com

    Wolfram Solutions

    • Data Science
    • Artificial Intelligence
    • Biosciences
    • Healthcare Intelligence
    • Sustainable Energy
    • Control Systems
    • Enterprise Wolfram|Alpha
    • Blockchain Labs

    More Wolfram Solutions

    Wolfram Solutions For Education

    • Research Universities
    • Colleges & Teaching Universities
    • Junior & Community Colleges
    • High Schools
    • Educational Technology
    • Computer-Based Math

    More Solutions for Education

    • Contact Us
  • Learning & Support

    Get Started

    • Wolfram Language Introduction
    • Fast Intro for Programmers
    • Fast Intro for Math Students
    • Wolfram Language Documentation

    Grow Your Skills

    • Wolfram U

      Courses in computing, science, life and more

    • Community

      Learn, solve problems and share ideas.

    • Blog

      News, views and insights from Wolfram

    • Resources for

      Software Developers
    • Tech Support
      • Contact Us
      • Support FAQs
    • More Learning
      • Highlighted Core Areas
      • Demonstrations
      • YouTube
      • Daily Study Groups
      • Wolfram Schools and Programs
      • Books
    • Support FAQs
    • Contact Us
  • Company
    • About Wolfram
    • Career Center
    • All Sites & Resources
    • Connect & Follow
    • Contact Us

    Work with Us

    • Student Ambassador Initiative
    • Wolfram for Startups
    • Student Opportunities
    • Jobs Using Wolfram Language

    Educational Programs for Adults

    • Summer School
    • Winter School

    Educational Programs for Youth

    • Middle School Camp
    • High School Research Program
    • Computational Adventures

    Read

    • Stephen Wolfram's Writings
    • Wolfram Blog
    • Wolfram Tech | Books
    • Wolfram Media
    • Complex Systems
    • Educational Resources
      • Wolfram MathWorld
      • Wolfram in STEM/STEAM
      • Wolfram Challenges
      • Wolfram Problem Generator
    • Wolfram Initiatives
      • Wolfram Science
      • Wolfram Foundation
      • History of Mathematics Project
    • Events
      • Stephen Wolfram Livestreams
      • Online & In-Person Events
    • Contact Us
    • Connect & Follow
  • Wolfram|Alpha
  • Wolfram Cloud
  • Your Account
  • User Portal
Wolfram Language & System Documentation Center
CurrentValue
  • See Also
    • AbsoluteCurrentValue
    • MousePosition
    • ControllerState
    • MouseAnnotation
    • Options
    • SetOptions
    • SystemOptions
    • ControlActive
    • ThemeColor
    • NotebookInformation
    • NotebookCellData
    • $FontFamilies
  • Related Guides
    • Dynamic Interactivity Language
    • Custom Interface Construction
    • Low-Level Notebook Programming
    • Programmatic Notebook & Interface Customization
    • Creating Inspectors
    • Low-Level Interface Control
    • Stylesheets
    • External Operations
    • Notebook & Interface Customization
    • Wolfram System Session Information
  • Workflows
    • Add Words to the Spelling Dictionary
    • Find the Edit History of a Notebook
  • Tech Notes
    • Introduction to Dynamic
    • Advanced Dynamic Functionality
    • See Also
      • AbsoluteCurrentValue
      • MousePosition
      • ControllerState
      • MouseAnnotation
      • Options
      • SetOptions
      • SystemOptions
      • ControlActive
      • ThemeColor
      • NotebookInformation
      • NotebookCellData
      • $FontFamilies
    • Related Guides
      • Dynamic Interactivity Language
      • Custom Interface Construction
      • Low-Level Notebook Programming
      • Programmatic Notebook & Interface Customization
      • Creating Inspectors
      • Low-Level Interface Control
      • Stylesheets
      • External Operations
      • Notebook & Interface Customization
      • Wolfram System Session Information
    • Workflows
      • Add Words to the Spelling Dictionary
      • Find the Edit History of a Notebook
    • Tech Notes
      • Introduction to Dynamic
      • Advanced Dynamic Functionality

CurrentValue[item]

gives the current value of item at a location in the Wolfram System and interface.

CurrentValue[{item,spec}]

gives the current value for the feature of item specified by spec.

CurrentValue[obj,item]

gives the current value of item associated with the object obj.

CurrentValue[{obj1,obj2,…},item]

gives a list of the current values associated with each of the obji.

Details
Details and Options Details and Options
Examples  
Basic Examples  
Scope  
Options  
Fonts  
Colors  
Show More Show More
Mouse  
Notebook  
Keyboard  
Selection  
Evaluation  
Setting Values  
Applications  
Properties & Relations  
Possible Issues  
See Also
Tech Notes
Related Guides
Related Workflows
History
Cite this Page
BUILT-IN SYMBOL
  • See Also
    • AbsoluteCurrentValue
    • MousePosition
    • ControllerState
    • MouseAnnotation
    • Options
    • SetOptions
    • SystemOptions
    • ControlActive
    • ThemeColor
    • NotebookInformation
    • NotebookCellData
    • $FontFamilies
  • Related Guides
    • Dynamic Interactivity Language
    • Custom Interface Construction
    • Low-Level Notebook Programming
    • Programmatic Notebook & Interface Customization
    • Creating Inspectors
    • Low-Level Interface Control
    • Stylesheets
    • External Operations
    • Notebook & Interface Customization
    • Wolfram System Session Information
  • Workflows
    • Add Words to the Spelling Dictionary
    • Find the Edit History of a Notebook
  • Tech Notes
    • Introduction to Dynamic
    • Advanced Dynamic Functionality
    • See Also
      • AbsoluteCurrentValue
      • MousePosition
      • ControllerState
      • MouseAnnotation
      • Options
      • SetOptions
      • SystemOptions
      • ControlActive
      • ThemeColor
      • NotebookInformation
      • NotebookCellData
      • $FontFamilies
    • Related Guides
      • Dynamic Interactivity Language
      • Custom Interface Construction
      • Low-Level Notebook Programming
      • Programmatic Notebook & Interface Customization
      • Creating Inspectors
      • Low-Level Interface Control
      • Stylesheets
      • External Operations
      • Notebook & Interface Customization
      • Wolfram System Session Information
    • Workflows
      • Add Words to the Spelling Dictionary
      • Find the Edit History of a Notebook
    • Tech Notes
      • Introduction to Dynamic
      • Advanced Dynamic Functionality

CurrentValue

CurrentValue[item]

gives the current value of item at a location in the Wolfram System and interface.

CurrentValue[{item,spec}]

gives the current value for the feature of item specified by spec.

CurrentValue[obj,item]

gives the current value of item associated with the object obj.

CurrentValue[{obj1,obj2,…},item]

gives a list of the current values associated with each of the obji.

Details

  • CurrentValue by default refers to the location at which it appears in a notebook structure.
  • CurrentValue may be used inside Dynamic, where it by default refers to the dynamic object being displayed.
  • Values for appropriate items can be reset using CurrentValue[item]=val, or implicitly through Dynamic.
  • For any option in the notebook front end, the current value at a particular location can be accessed using CurrentValue[opt].
  • For options whose settings are lists of the form {"name1"->val1,…}, CurrentValue[{opt,namei}] picks out the current value of vali.
  • CurrentValue[{StyleDefinitions,"style"}] gives the explicit style definitions that would be used for the style with name style at the current location.
  • CurrentValue[{StyleDefinitions,"style",option}] gives the value of option for style.
  • CurrentValue[obj,"CellStyleName"] returns the primary cell style name assigned to obj as a string. CurrentValue[obj,"CellStyle"] gives a list of all the cell styles assigned to obj.
  • Possible special items that can be used in CurrentValue include:
  • "MouseOver"True if the mouse is over the location
    "SelectionData"the contents of the selection in this notebook
    "SelectionOver"True if the selection includes the current location
    "SelectionWithin"True if the selection is entirely within the current location
  • The following refer to the mouse:
  • "MouseButtons"a list of mouse buttons currently pressed
    "MouseButtonTest"True if the main mouse button is currently pressed
    {"MouseButtonTest",i}True if mouse button i is currently pressed
    "MouseClickCount"number of mouse clicks for the triggering event
    "MouseOver"True if the mouse is over the current location
    "MousePosition"the current position of the mouse
    {"MousePosition",coords}the mouse position in the specified coordinate system
  • The primary mouse button is represented as 1. The secondary ("right") button is 2. The scroll wheel button is typically 3. Additional buttons are given higher numbers.
  • The following refer to modifier keys:
  • "ModifierKeys"a list of all modifier keys currently being pressed
    "AltKey"True if the or key is currently pressed
    "CommandKey"True if the or key is currently pressed
    "ControlKey"True if the key is currently pressed
    "OptionKey"True if the key on a Macintosh is currently pressed
    "ShiftKey"True if the key is currently pressed
  • The following refer to controller devices such as gamepads:
  • "ControllerData"low‐level data on states of all controllers
    {"ControllerData",ids}data on controllers with the specified identifiers
  • The following refer to the event or action currently being handled:
  • "EventKey"key that was pressed
    "EventAbsoluteTime"absolute time when the event occurred
    "EventData"data about the event
  • The following refer to the evaluation currently being performed:
  • "DynamicEvaluation"True if the evaluation is associated with Dynamic
    "SynchronousEvaluation"True if the evaluation is being performed synchronously
  • The following special items refer to the complete current notebook:
  • "NotebookDirectory"directory name
    "NotebookFileName"name of file, without path
    "NotebookFullFileName"full file name, including path
    "NotebookSelected"True if the notebook is selected
  • The following refer to the font being used; all are given in printer's points:
  • "FontAscenderHeight"height of ascenders for lowercase letters
    "FontAxisOffset"offset of the font axis above the baseline
    "FontCapHeight"height of capital letters
    "FontDescenderDepth"depth of descenders for lowercase letters
    "FontLineHeight"total height of lines of text
    "FontMWidth"width of an "m"
    "FontNWidth"width of an "n"
    "FontThickness"default stroke thickness
    "FontXHeight"height of an "x"
  • The following refer to system settings:
  • "SystemColors"colors specified by the system's current theme
    "SystemFonts"fonts specified by the system's current theme
  • Typical objects that can be used in CurrentValue include:
  • $FrontEndthe whole front end
    $FrontEndSessionthe current session of the front end
    NotebookObject[…]the specified notebook; this may have been generated by a command such as InputNotebook or EvaluationNotebook
    NotebookSelection[nb]the current selection within a notebook
    CellObject[…]the specified cell; this may have been generated by a command such as Cells or EvaluationCell
    BoxObject[…]the specified box; this may have been generated by a command such as EvaluationBox
  • When used in functions like EventHandler and Button, CurrentValue returns the current value at the moment when the triggering event occurred.
  • Cases such as CurrentValue["MousePosition"] are equivalent to explicit functions such as MousePosition[].

Examples

open all close all

Basic Examples  (2)

Get the current mouse position:

Dynamically update the current value:

Scope  (21)

Options  (7)

Get the current value of an option for the front end:

Get the current value of an option for a notebook:

Get the current value of an option inherited by a Dynamic:

Get the current value of a suboption:

Get the current value of a specific rule within an option:

Get the current value of rules within rules within options:

Give a list of current values corresponding to several cell objects:

Fonts  (1)

Use platform-specific controls font:

Use platform-specific panel font:

Colors  (1)

Style elements to look similar to a tooltip:

Mouse  (2)

Detect whether the mouse cursor is over the content:

Get the absolute current position of the mouse on screen:

Get the scaled current position of the mouse on screen:

Get the mouse position inside a graphic:

Notebook  (3)

Check whether the current notebook is selected:

Get the notebook file name:

Get the directory path of the current notebook:

Get the full path of the current notebook:

Keyboard  (1)

Get a list of all modifier keys being pressed:

Check whether a specific modifier key is being pressed:

Selection  (2)

Detect whether current cell is selected:

Get the box structure of the selection in this notebook:

Select parts of the expression below:

Evaluation  (2)

Detect whether current evaluation is inside Dynamic:

Detect whether current evaluation is synchronous:

Setting Values  (2)

Set the notebook background to be red for a second and then reset to original value:

Use Dynamic to set the notebook background:

Or set the window opacity:

Applications  (1)

Use the TaggingRules option to store arbitrary metadata that will be saved with a notebook:

See the entire list of TaggingRules for a given selector:

Use TaggingRules to emulate a DynamicModule construct that can span cells:

Properties & Relations  (1)

Mouseover is created by the CurrentValue item "MouseOver":

Possible Issues  (1)

Dynamic may not be updated while mouse buttons are down, so this may show nothing:

See Also

AbsoluteCurrentValue  MousePosition  ControllerState  MouseAnnotation  Options  SetOptions  SystemOptions  ControlActive  ThemeColor  NotebookInformation  NotebookCellData  $FontFamilies

Function Repository: SelectByCurrentValue

Tech Notes

    ▪
  • Introduction to Dynamic
  • ▪
  • Advanced Dynamic Functionality

Related Guides

    ▪
  • Dynamic Interactivity Language
  • ▪
  • Custom Interface Construction
  • ▪
  • Low-Level Notebook Programming
  • ▪
  • Programmatic Notebook & Interface Customization
  • ▪
  • Creating Inspectors
  • ▪
  • Low-Level Interface Control
  • ▪
  • Stylesheets
  • ▪
  • External Operations
  • ▪
  • Notebook & Interface Customization
  • ▪
  • Wolfram System Session Information

Related Workflows

    Related Workflows
    ▪
  • Add Words to the Spelling Dictionary
  • ▪
  • Find the Edit History of a Notebook

History

Introduced in 2007 (6.0) | Updated in 2012 (9.0) ▪ 2019 (12.0) ▪ 2024 (14.0) ▪ 2025 (14.2)

Wolfram Research (2007), CurrentValue, Wolfram Language function, https://reference.wolfram.com/language/ref/CurrentValue.html (updated 2025).

Text

Wolfram Research (2007), CurrentValue, Wolfram Language function, https://reference.wolfram.com/language/ref/CurrentValue.html (updated 2025).

CMS

Wolfram Language. 2007. "CurrentValue." Wolfram Language & System Documentation Center. Wolfram Research. Last Modified 2025. https://reference.wolfram.com/language/ref/CurrentValue.html.

APA

Wolfram Language. (2007). CurrentValue. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/CurrentValue.html

BibTeX

@misc{reference.wolfram_2025_currentvalue, author="Wolfram Research", title="{CurrentValue}", year="2025", howpublished="\url{https://reference.wolfram.com/language/ref/CurrentValue.html}", note=[Accessed: 01-February-2026]}

BibLaTeX

@online{reference.wolfram_2025_currentvalue, organization={Wolfram Research}, title={CurrentValue}, year={2025}, url={https://reference.wolfram.com/language/ref/CurrentValue.html}, note=[Accessed: 01-February-2026]}

Top
Introduction for Programmers
Introductory Book
Wolfram Function Repository | Wolfram Data Repository | Wolfram Data Drop | Wolfram Language Products
Top
  • Products
  • Wolfram|One
  • Mathematica
  • Notebook Assistant + LLM Kit
  • Compute Services
  • System Modeler

  • Wolfram|Alpha Notebook Edition
  • Wolfram|Alpha Pro
  • Mobile Apps

  • Wolfram Engine
  • Wolfram Player

  • Volume & Site Licensing
  • Server Deployment Options
  • Consulting
  • Wolfram Consulting
  • Repositories
  • Data Repository
  • Function Repository
  • Community Paclet Repository
  • Neural Net Repository
  • Prompt Repository

  • Wolfram Language Example Repository
  • Notebook Archive
  • Wolfram GitHub
  • Learning
  • Wolfram U
  • Wolfram Language Documentation
  • Webinars & Training
  • Educational Programs

  • Wolfram Language Introduction
  • Fast Introduction for Programmers
  • Fast Introduction for Math Students
  • Books

  • Wolfram Community
  • Wolfram Blog
  • Public Resources
  • Wolfram|Alpha
  • Wolfram Problem Generator
  • Wolfram Challenges

  • Computer-Based Math
  • Computational Thinking
  • Computational Adventures

  • Demonstrations Project
  • Wolfram Data Drop
  • MathWorld
  • Wolfram Science
  • Wolfram Media Publishing
  • Customer Resources
  • Store
  • Product Downloads
  • User Portal
  • Your Account
  • Organization Access

  • Support FAQ
  • Contact Support
  • Company
  • About Wolfram
  • Careers
  • Contact
  • Events
Wolfram Community Wolfram Blog
Legal & Privacy Policy
WolframAlpha.com | WolframCloud.com
© 2026 Wolfram
© 2026 Wolfram | Legal & Privacy Policy |
English