The placeholder system is a powerful tool to customize and personalize individual passes for every user. PassSlot's placeholder system is unprecedented in flexibility and has major benefits compared to other solutions by other Wallet service providers.
Placeholders can be used e.g. to show the user's name on the pass, show a custom message to the user or even allow to configure custom geo-location points for stores that are nearest to the user. You can think of the placeholder system as a database or spreadsheet. Every placeholder defines a field that needs to be filled in when creating an new row (pass). You can create as many placeholders as you like for every template. Creating a placeholder is as easy as typing ${firstName} anywhere on the template (see more at creating placeholder).
Every time a pass needs to be generated from the template, PassSlot ensure that all necessary placeholder have values. A corresponding form will e.g. be presented to the user before he can generate his pass. It is also possible to provide the values for placeholders directly via API when creating a new pass.
After a pass is generated, every time you change the value of a placeholder of that individual pass , the PassSlot system will ensure that the pass is properly updated and the auto-push system ensure that the pass gets a notification
ℹ️ Tip: Placeholders can be used anywhere in the template, not only inside text fields. Further placeholder can be used multiple times at different location. They actually can appear in any location inside the whole pass JSON, even parts that are not visible to the users. This can be powerful if you want to do advanced customizations, e.g. you can use a placeholder for the passes geo-fence locations (JSON array) that you will provide during pass creation
ℹ️ Tip: Create placeholder for every "atomic" data / value / text. If you want to put the users name on the pass, use a placeholder for the first name and one for the last name. Because you can have multiple placeholders inside the same field, you can still show the complete name, but in the future you can e.g. use the first name somewhere else on the pass
ℹ️ Tip: Placeholder can be used as a simple way to collect data such as email addresses or phone numbers. There is no requirement that you use a placeholder on the template or show its value on a pass.