Field Interpolation

A number of wizard setting text inputs support wizard field and user field interpolation. This means that you can insert wizard or user data into blocks of text that the user sees in the wizard.

“Interpolation” noun. The insertion of something of a different nature into something else.


The basic usage of field interpolation is w{field_id} for wizard fields and u{field_name} for user fields.


For example, if you have a field with the id “step_1_field_1” where a user enters their name, you can use that field in a post template using w{step_1_field_1}.




You must use the exact field ids, not the field labels, and exact user properties. You can see the field ids in (brackets) next to the field label.

Screen Shot 2020-04-16 at 1.54.12 PM
If the value stored in the wizard field is an object, you can use dot notation to access properties of that object.


For example, the value of an Upload field is an object that looks like this:

{“id”=>“17099”, “url”=>"//", “original_filename”=>“DSC_2513 - NPN 1500px 2020.03.07.jpg”, “filesize”=>“422440”, “width”=>“1500”, “height”=>“956”, “thumbnail_width”=>“690”, “thumbnail_height”=>“439”, “extension”=>“jpeg”, “short_url”=>“upload://n506tVd67Ud4VTMlxqt8nIZPTPD.jpeg”, “short_path”=>"/uploads/short-url/n506tVd67Ud4VTMlxqt8nIZPTPD.jpeg", “retain_hours”=>"", “human_filesize”=>“413 KB”}

To interpolate the url of the upload into a field, use the notation w{field_id.url}. This allows you to interpolate an image uploaded via an Upload field into a post.



Where it’s supported

Field interpolation is supported in certain text inputs.

Step descriptions

Step descriptions currently only support user fields.

Post builder (actions)

You can interpolate any fields of the wizard user, and any wizard fields in a post builder.

Text inputs

You can interpolate any fields of the wizard user in any text input. You can also interpolate any wizard field in a text input in an action.

Screen Shot 2020-04-16 at 3.20.42 PM


Great documentation, kudos! :clap:

when publishing as a topic, is there a way to interpolate a wizard dropdown field’s key and value fields? Have tried w{field.key} and w{field.value} and similar to no avail.

@per Hope you don’t mind that I moved your reply to this topic, as I suspect this is what you’re after?

1 Like

Sounds absolutely reasonable @angus :slight_smile:

However, I fail to understand if it is possible to interpolate both key and value fields from dropdown fields when an action creates a topic? Is there a way to check which values are possible to interpolate per field type? Ie, put another way, is there a way to check what each object looks like as per the example above?

Hey @angus, is it possible to take a User Customised Field and interpolate it?

I ask because I need to ask people’s background for approvals as a UCF (pre signup wizard), and then would like to give them the opportunity to improve upon what they wrote before inserting it into bio_raw.

We currently cannot use Update Profile in Actions to map a UF (or UCF) to another User Field. I also tried to just push it from my UCF to bio_raw using the Custom feature of Update Profile in Actions, but couldn’t make it work.

Any thoughts?


Sorry, just so I’m clear, the flow here is:

  1. Take input in custom field in sign up form
  2. Edit input in text field in custom wizard
  3. Map edited input to bio_raw

Is there anything else being inserted in bio_raw, or just the contents of this field? If there’s nothing else, you should use the action mapping, i.e. that’s where we’ll focus.

That is exactly what I mean, with the possible exception of using a composer for the field.

As a general principle it would be absolutely lovely to be able to use/interpolate UCFs in the same way as the standard user fields in the step and field texts. This would do the job just fine as the user could then just copy and paste as they wished. And it would be useful for a bunch of things.

Hey Angus

How would display more that one uploaded image into a post? In my specific case the number of images uploaded in the wizard is not defined.

Inserting multiple images in the post builder would look something like this.

My first image

My second image

However, unless I’m reading you wrong, you want the fields inserted to be dynamic, i.e. you don’t know which fields should be inserted beforehand. Is that because you’re not sure which fields will have uploads? i.e. some might be empty?

If that’s the case, you have two options currently:

  1. Make all fields being interpolated a required field

  2. Interpolate empty fields

There’s no optional interpolation at this time. One improvement might be something like “don’t interpolate if the field has no input”. That’s something I would consider as a new feature. If that’s the need, please make a feature request here: Feature Request

not quiet

different submissions will upload different numbers of images. some only one, others 3, others maybe 7.
Hence I don’t know how to add put that into composer as output.

1 Like

When the field type is Category, w{step_2_field_1} outputs the category number quoted inside brackets, i.e. [“6”] instead of the category name. How do I output the name?

Same thing when the field type is a tag.

Field types checkbox and textarea output only true if user supplied text in textarea or **** if left empty. I want the user-supplied text to be outputted.

EDIT: I’m using field type Dropdown with mapped content to achieve my goal and resolve my previous issues.

You can do that by using a Category type field, and then choosing ‘slug’ in Property (under Advanced):

Although it would be very nice to have Category name as one of the options!!

1 Like