---
title: Using Variables in Acquire Editor
description: Using Variables in Acquire Editor
---
[Skip to content](https://knowledge.acquiredigital.com/using-variables-in-acquire-editor#main-content)
English
Show submenu for translations
[More support](https://knowledge.acquiredigital.com/kb-tickets/new?hsLang=en) [Support Portal](https://knowledge.acquiredigital.com/support?hsLang=en)
Open main navigation
Close main navigation
- English
Show submenu for translations
- [More support](https://knowledge.acquiredigital.com/kb-tickets/new)
- [Support Portal](https://knowledge.acquiredigital.com/support)
- Contact us
Contact us
How can we help you?
- There are no suggestions because the search field is empty.
1. [Acquire Digital Knowledgebase](https://knowledge.acquiredigital.com/?hsLang=en)
2. [Acquire Premier](https://knowledge.acquiredigital.com/acquire-premier?hsLang=en)
3. [Acquire Editor FAQs](https://knowledge.acquiredigital.com/acquire-premier?hsLang=en#acquire-editor-faqs)
# Using Variables in Acquire Editor
## What are variables and how do I use them in my project?
**Resolution:**
One of the most powerful features of Acquire is its ability to use **Variables.** Variables are basically names you give to post boxes that can themselves contain information or values. You can create a variable called **numberofpictures** and use it to store how many pictures you have (likewise it may be called **fred** or **gobbledigook** but you are more likely to remember what **numberofpictures** is used for).
In most places in the editor, you can use variables instead of manually putting a value, which can be immensely useful in reducing the amount of work you need to do. Acquire knows that you mean to use a variable by using **two dollar signs** in front of the variable name **($$).** There are also some special variables that Acquire creates itself that you can use in your projects. These are signified by **two dollar signs** and an **underscore** **($$\_)**.
As an example, you could put **Hello & Welcome to our Store** in a text box on a page.
Or you could put **$$message** into the text box and somewhere set (see shortly to find out how) **$$message** to be **Hello & Welcome to our Store**and it will show the same thing.
Or you could put **Hello & Welcome to our** **$$message store in** into the text box and set **$$message** to be **London**, **Paris**, **Rome**, **etc** on the respective player. By doing this, you can simply make and manage one page, and by setting the variables appropriately, all of the players will show a different message, especially useful for projects deployed to different locations.
As described above, you can use variables in most places in Acquire. You can use it as the file name of a piece of media, or as part of a URL for CyberBrowser or one of the helpers, or many more.
You can set and change variables in a number of places in Acquire:
- When a page shows/exits (on the Page control in the Page Designer)
- When an item is clicked
- In an Auto-line event in a playlist
- In an ACQ (see ACQ documentation for more information)
- In a helper (see helper documentation for more information)
- When Acquire Player starts (uses the variables.ini file, or create one)
- From external programs
- Using the CiY code management system
- Within Adobe Flash animations
However, the best location to change variables is by using the Group Editor and setting the groups to have specific values set for specific variables - then any players assigned to that group will receive those variables.
**System Variables:**
System variables are ones which are typically created from within Acquire's system and can be used to discover information for use in your projects.
$$\_channelscript - if this is set to a valid playlist (script) name. This playlist will play instead of the one scheduled to play from the editor. The playlist name must include the complete filename (including the .aqs suffix)
These variables are available for read access at any time and cannot be changed.
They provide your applications and any ACQs or helpers with details of system values
**Time related:**
- $$\_time - Current Time as specified in windows locale
- $$\_date - Current Date as specified in windows locale
- $$\_Hour12 - Current Hour of day in 12 hour format (see AMPM flag)
- $$\_Hour24 - Current Hour in 24 hour format
- $$\_AMPM - Flag showing AM (morning) or PM (evening)
- $$\_min - Minute of Hour
- $$\_sec - Second
- $$\_day – The day of the month
- $$\_dow –The current day of the week (Monday, Tuesday, etc)
- $$\_month – The month of the year (numerical)
- $$\_monthname – the month of the year (January, February, etc)
- $$\_year – The current year
- $$\_datefmt\[\]- This uses the standard functions to choose the date and time fields. Choose from:
1. c - shortdateformat + ' ' + longtimeformat
2. d - day of month
3. dd - day of month (leading zero)
4. ddd - day of week (abbreviation)
5. dddd - day of week (full)
6. ddddd - shortdateformat
7. dddddd - longdateformat
8. m - month
9. mm -month (leading zero)
10. mmm - month (abbreviation)
11. mmmm -month (full)
12. y - year (2 digits)
13. yy - year (two digits)
14. yyyy - year (with century)
15. h - hour
16. hh -hour (leading zero)
17. n - minute
18. nn - minute (leading zero)
19. s - second
20. ss - second (leading zero)
21. t - shorttimeformat
22. tt - longtimeformat
23. am/pm - use 12 hour clock and display am and pm accordingly
24. a/p -use 12 hour clock and display a and p accordingly
25. / - insert date seperator
26. : - insert time seperator
27. "xx" - literal text
28. 'xx' - literal text
29. Z -milliseconds
30. Zzz - milliseconds (leading zero)
- $$\_now - Current Date and Time as specified in windows locale
- $$\_playername - Player name as set in Engineer Settings / on the PLUS! Network
- $$\_playerdesc - Player description as set in Engineer Settings
- $$\_monitorno - ID of the monitor Acquire is set to display on
- $$\_machineid - Unique ID of the player
- $$\_sequencenumber - If using more than one player at a site (e.g. using synchronisation), this is the position in the sequence.
- $$\_errorhappened - Details of whether an error in a deployment occurred since the player was started (0 or 1)
- $$\_lasterror - Text Details of any errors the last error since the player was started
- $$\_projectid - Unique project ID (also used as foldername for deployments)
- $$\_projectname - Currently chosen project name
- $$\_projectmedia - Currently chosen project Media folder complete path
- $$\_projectscripts - Currently chosen project Scripts folder complete path
- $$\_projecthelpers - Currently chosen project Helpers folder complete path
- $$\_pageid - current page ID
- $$\_pagename - current page name
- $$\_ipaddress - IP address of the player (note this is the first active network connection)
- $$\_macaddress- MAC address of the player (note this is the first active network connection)
- $$\_screenwidth - Current screen resolution
- $$\_screenheight - Current screen resolution
- $$\_volumeleft – Volume of the Master Mixer (Left Channel) 0 to 100
- $$\_volumeright – Volume of the Master Mixer (Right Channel) 0 to 100
- $$\_NULL: - Does nothing, useful if you want to stop something being picked up as a variable (e.g.: $$thisid$$\_null:.jpg would work out $$thisid and add .jpg on the end rather than seeing $$thisid.jpg as the variable name)
- $$\_EVAL\[\] - Simple expression evaluator. For example $$\_EVAL\[ 5+5 \] will return 10, or $$\_EVAL\[ $$var1 + $$var2 \] will add the vaules in $$var1 and $$var2, so when these are 3 and 4 the result will be 7, whereas if they are 'hello' and 'there' the result will be 'hellothere' (make sure you put spaces between each part)
- $$\_RSS\[\] – Access ALL RSS Data as a variable. This makes it much more flexible
- Usage: $$\_rss\[feedid,storyindex,command\]
feedid is shown in the RSS helper.
StoryIndex is a number starting at 0 of the story to show
- Command is what you want
Commands are:
- Title - Story Title
- Story - Story content
- Mediafile - Media related to this story
- Mediadesc - Description of the media
- url - URL to the full story
- pubdate - Published date of the story
This is different, format is $$\_rss\[feedid, storyindex, pubdate, format\]
“format” field is the same parameters as $$\_datefmt\[\]
- $$\_SETIF\[\] – Inline command. Sets a variable to a value if a specific condition is met.
- $$\_setif\[$$variable,value,expression\] E.g.:
- $$\_setif\[$$myvar,1, $$var2 = 10\] would set $$myvar to 1 if $$var2=10
- $$\_JUMPIF\[\] – Inline command. Jumps to a different page if a specific condition is met.
- $$\_jumpif\[pageid,expression\]
- $$\_QUITIF\[\] – Inline command. Quits the current page if a specific condition is met
- $$\_quitif\[expression\]
- $$\_TIMEOUTIF\[\] – Inline command. Times out the current page if a specific condition is met. $$\_timeoutif\[expression\]
- $$\_ticks – Returns the number of milliseconds since Windows loaded. This number will reset about every 22 days. Useful for measuring timings.
- [Software Installers](https://knowledge.acquiredigital.com/software-installers?hsLang=en)
- [StudioDX & DX Player](https://knowledge.acquiredigital.com/studiodx-dx-player?hsLang=en#main-content)
- [Studio DX FAQ's](https://knowledge.acquiredigital.com/studiodx-dx-player?hsLang=en#studio-dx-faqs)
- [Acquire StudioDX User Documentation](https://knowledge.acquiredigital.com/studiodx-dx-player?hsLang=en#acquire-studiodx-user-documentation)
- [User Guide](https://knowledge.acquiredigital.com/studiodx-dx-player?hsLang=en#user-guide)
- [Widgets](https://knowledge.acquiredigital.com/studiodx-dx-player?hsLang=en#widgets)
- [Transitions](https://knowledge.acquiredigital.com/studiodx-dx-player?hsLang=en#transitions)
- [Warning Alerts](https://knowledge.acquiredigital.com/studiodx-dx-player?hsLang=en#warning-alerts)
- [Setup App](https://knowledge.acquiredigital.com/studiodx-dx-player?hsLang=en#setup-app)
- [Project Apps](https://knowledge.acquiredigital.com/studiodx-dx-player?hsLang=en#project-apps)
- [StudioDX Stream Deck Plugin](https://knowledge.acquiredigital.com/studiodx-dx-player?hsLang=en#studiodx-stream-deck-plugin)
- [XML Formats](https://knowledge.acquiredigital.com/studiodx-dx-player?hsLang=en#xml-formats)
- [Acquire Wayfinder](https://knowledge.acquiredigital.com/acquire-wayfinder?hsLang=en#main-content)
- [Map Editor - Atlas](https://knowledge.acquiredigital.com/acquire-wayfinder?hsLang=en#map-editor-atlas)
- [Devices](https://knowledge.acquiredigital.com/acquire-wayfinder?hsLang=en#devices)
- [CMS User Management](https://knowledge.acquiredigital.com/acquire-wayfinder?hsLang=en#cms-user-management)
- [Project Settings](https://knowledge.acquiredigital.com/acquire-wayfinder?hsLang=en#project-settings)
- [The Map Editor](https://knowledge.acquiredigital.com/acquire-wayfinder?hsLang=en#the-map-editor)
- [JS Web Map UI V2.0](https://knowledge.acquiredigital.com/acquire-wayfinder?hsLang=en#js-web-map-ui-v2-0)
- [JS Web Map API V2.0](https://knowledge.acquiredigital.com/acquire-wayfinder?hsLang=en#js-web-map-api-v2-0)
- [JS Web Directory API V1.0](https://knowledge.acquiredigital.com/acquire-wayfinder?hsLang=en#js-web-directory-api-v1-0)
- [Wayfinder Map API](https://knowledge.acquiredigital.com/acquire-wayfinder?hsLang=en#wayfinder-map-api)
- [Broadsign Integration](https://knowledge.acquiredigital.com/acquire-wayfinder?hsLang=en#broadsign-integration)
- [Adverts Plugin](https://knowledge.acquiredigital.com/acquire-wayfinder?hsLang=en#adverts-plugin)
- [Wayfinder FAQs](https://knowledge.acquiredigital.com/acquire-wayfinder?hsLang=en#wayfinder-faqs)
- [Beacon](https://knowledge.acquiredigital.com/beacon?hsLang=en#main-content)
- [Devices](https://knowledge.acquiredigital.com/beacon?hsLang=en#devices)
- [Layouts](https://knowledge.acquiredigital.com/beacon?hsLang=en#layouts)
- [Information Displays](https://knowledge.acquiredigital.com/beacon?hsLang=en#information-displays)
- [Playlists](https://knowledge.acquiredigital.com/beacon?hsLang=en#playlists)
- [Project Settings](https://knowledge.acquiredigital.com/beacon?hsLang=en#project-settings)
- [Activity Logs](https://knowledge.acquiredigital.com/beacon?hsLang=en#activity-logs)
- [Acquire DOOHAD](https://knowledge.acquiredigital.com/acquire-doohad?hsLang=en#main-content)
- [DOOHAd Standalone Installer & Advert Configuration Tool](https://knowledge.acquiredigital.com/acquire-doohad?hsLang=en#doohad-standalone-installer-advert-configuration-tool)
- [DooHad FAQs](https://knowledge.acquiredigital.com/acquire-doohad?hsLang=en#doohad-faqs)
- [Acquire Vision User Guide](https://knowledge.acquiredigital.com/acquire-vision-user-guide?hsLang=en)
- [Acquire StudioDX & Wayfinder Trial Install Guides](https://knowledge.acquiredigital.com/acquire-studiodx-wayfinder-trial-install-guides?hsLang=en#main-content)
- [Acquire Wayfinder Trial](https://knowledge.acquiredigital.com/acquire-studiodx-wayfinder-trial-install-guides?hsLang=en#acquire-wayfinder-trial)
- [Acquire StudioDX Trial Installation Guide](https://knowledge.acquiredigital.com/acquire-studiodx-wayfinder-trial-install-guides?hsLang=en#acquire-studiodx-trial-installation-guide)
- [Acquire Assist](https://knowledge.acquiredigital.com/acquire-assist?hsLang=en)
- [Acquire Premier](https://knowledge.acquiredigital.com/acquire-premier?hsLang=en#main-content)
- [Quick Start Guide.](https://knowledge.acquiredigital.com/acquire-premier?hsLang=en#quick-start-guide)
- [Acquire Editor User Guide](https://knowledge.acquiredigital.com/acquire-premier?hsLang=en#acquire-editor-user-guide)
- [Toolbox](https://knowledge.acquiredigital.com/acquire-premier?hsLang=en#toolbox)
- [The PLUS! Network](https://knowledge.acquiredigital.com/acquire-premier?hsLang=en#the-plus-network)
- [Acquire Site Manager](https://knowledge.acquiredigital.com/acquire-premier?hsLang=en#acquire-site-manager)
- [Apps & Helpers Manuals](https://knowledge.acquiredigital.com/acquire-premier?hsLang=en#apps-helpers-manuals)
- [Minute Master-Classes](https://knowledge.acquiredigital.com/acquire-premier?hsLang=en#minute-master-classes)
- [Acquire Editor FAQs](https://knowledge.acquiredigital.com/acquire-premier?hsLang=en#acquire-editor-faqs)
- [Acquire Player FAQs](https://knowledge.acquiredigital.com/acquire-player-faqs?hsLang=en)
- [Site Manager](https://knowledge.acquiredigital.com/site-manager?hsLang=en#main-content)
- [Site Manager User Guide](https://knowledge.acquiredigital.com/site-manager?hsLang=en#site-manager-user-guide)
- [Site Manager FAQs](https://knowledge.acquiredigital.com/site-manager?hsLang=en#site-manager-faqs)
- [Watchdog](https://knowledge.acquiredigital.com/watchdog?hsLang=en#main-content)
- [Watchdog User Guide](https://knowledge.acquiredigital.com/watchdog?hsLang=en#watchdog-user-guide)
- [Watchdog FAQs](https://knowledge.acquiredigital.com/watchdog?hsLang=en#watchdog-faqs)
- [FAQs](https://knowledge.acquiredigital.com/faqs?hsLang=en)
[](http://acquiredigital.com)
[mailto:email@email.com](mailto:email@email.com)
Copyright © 2026, Acquire Digital