Tags are a way to specify arguments in Summit Event Language (SEL) and help clarify assumptions about your model and logic to yourself and other readers.

You can define a tag in a SEL expression by entering text between two brackets, < and >, like so:

=100<users>

If the event is titled "New Customers", the tag is helpful for clarifying that the 100 refers to 100 users, and not 100 accounts or contracts.

Tags can be placed after any constants, inside or outside of lists and function calls. For example:

=Source(1.5k<opportunities> @ 2%)

💡 Notes:

In addition to acting as convenient labels in SEL, tags have another special purpose: to define input Parameters! Parameters are used to create forms in the Forms View of an event and the input fields in the app view of app view of a model.

Using the example =Source(1.5k<opportunities>), <opportunities> is the tag and opportunities is now a parameter in the model.

A parameter is powerful because it allows you to update multiple values at once across one or multiple SEL expressions. For example,

=Pool(100<credits> + (1.2<multiplier> * 100<credits>))

In this case, changing the value of credits (e.g. using a Form) to 200 will replace both of the 100s with 200.

💡 Note on Parameter formatting: As a best practice, a parameter should be written lowercase_without_spaces_or_symbols. For example: metric_tons. While Metric Tons would also work, spaces and capitalization add additional complexity that can make your model more difficult to work with as it becomes more advanced.

Sometimes reading or explaining an event formula or expression can be a bit complicated, so we've made it simple to use Summit Event Language (SEL) to convert those expressions into easy-to-understand Forms in the Editor View.

Simply add text between angle brackets < > after the values in an expression that you wish to display as form fields (i.e. inputs) for a given event. This creates a Tag for that value and will become the form field label when switching from the Expression View to the Form View of the event.

For example, if you wish to create an event that represents revenue with a steady growth rate, you might start by writing the formula as: =Source(10k @ 5%)

To display the formula or expression inputs as a form, choose the form field label by entering text directly next to each relevant value between angled brackets: =Source(10k<revenue> @ 5<%_growth>%)

After entering the field names, click the </> icon to view the event as a form. Now you can edit the formula's inputs by simply changing the values in the form fields!

💡 Notes on Forms:

When a tag is converted to an input field using the Form View, by default, the Summit Editor will convert the tag to Title Case for the form label on the event, like so:

As you can see, this isn't always ideal, because USD should be capitalized in full instead of Usd. We can fix this using an Alias. An alias appears in a tag after the parameter and a : colon, like so:

=Pool(100k<cash_balance_usd:Cash Balance USD>)

In this example, the form label will now be Cash Balance USD.

This gives you the freedom and flexibility to have the label appear differently than the parameter name, or to overwrite the automatic change to Title Case by default.

🔔 Note: Unlike tags and parameters, aliases can contain spaces, special characters, numbers, and uppercase letters.

Aliases also allow you to make it clear that the same parameter used in different places has different meanings. For example:

=Pool(100k<amount:Savings>)

=100k<amount:Savings Portion> + 30k

In this case, the SEL author wants the 100k value to use the same parameter, but to label this value differently on separate events.

Keep Reading: Preview & Configure Your App