Chapter 12: The XML Dialplan | FreeSWITCH Users Manual

Publisher

SignalWire

URL

https://developer.signalwire.com/freeswitch/dialplan/xml/

Published

unknown

Updated

unknown

Accessed

2026-09-24

HTTP status

200

License

SignalWire documentation site terms; no open licence stated on page; no-redistribution; short excerpts and locators only

Source notes citing this source

• A dialplan condition's break attribute defaults to on-false, so a failed condition stops evaluation of that extension; the other values are on-true, always and never. in context
• Capture groups in a condition's expression become $1 through $N in later action data, and the full match is available as ${DP_MATCH}. in context
• Unauthenticated inbound calls enter the dialplan context named by the SIP profile's context parameter, while calls from authenticated directory users enter the context in that user's user_context variable. in context
• The vanilla configuration's dialplan in conf/dialplan/ provides three contexts: default, public and features. in context
• mod_dialplan_xml checks a context's extensions in document order and runs the actions of the first extension whose conditions all match; continue="true" on an extension lets evaluation go on to the next extension after a match. in context
• The FreeSWITCH XML dialplan nests elements as context, then extension, then condition, then action or anti-action. in context
• Actions marked inline, such as set or export, run immediately while the dialplan is being evaluated instead of being queued. in context
• The public context acts as a security perimeter: it accepts only specific destination numbers and transfers them into the default context. in context

Cite this source record

APA

WarmTransfer. (2026, September 24). Chapter 12: The XML Dialplan | FreeSWITCH Users Manual. WarmTransfer. https://warmtransfer.net/knowledge/sources/signalwire-fs-manual-xml-dialplan

BibTeX

@misc{warmtransfer-signalwire-fs-manual-xml-dialplan,
  title  = {Chapter 12: The XML Dialplan | FreeSWITCH Users Manual},
  author = {{WarmTransfer}},
  year   = {2026},
  url    = {https://warmtransfer.net/knowledge/sources/signalwire-fs-manual-xml-dialplan},
  note   = {SignalWire, accessed 2026-09-24}
}