How to manually map fields that do not appear in the sample data (aka "custom pill mapping")

How to manually map fields that do not appear in the sample data (aka "custom pill mapping")
Userlevel 5

Hi all, this is Erin Oz from the Zapier Premier Support Team with a tip for creating custom “pills” to map fields in Zapier. 

Background Info

Some apps have a hard-coded sample that is retrieved when creating a new trigger. In apps that allow custom fields, this can lead to a situation where the custom fields you’d like to use later in the Zap’s action steps are not shown in the sample. 

This often leads to placeholder errors, because the field sent in a live call is different than the field mapped from the sample. 


For example, let’s say your trigger pulls in a default sample that shows an Address field:


(view larger)

You build your Zap, and you map the Address to the destination field in your action step. 


(view larger)

But in your live form, the address field is called “Street Address”. When you turn your Zap on and it runs, you’ll see a placeholder error: 


(view larger)

This can be confusing, because the address field present in the sample was mapped! In this case, the problem is that the sample used the name “Address” for the field name, and the live run used the name “Street Address”. 

Whenever you see {{...}} curly braces around entries in the Data In of an action, this means that there is a field mapped there in the Zap Editor, but when the Zap ran live this data was not sent from a previous step.

What we can do is create a custom pill mapping with the field name we expect in the live data.

Pill Mapping Code

If you copied and pasted this pill showing “First Name: Steve” from the Zapier Editor into a plain text editor (or even your browser’s address bar, which will quickly remove formatting in your pasted text):


(view larger)


You would see code that looks like this:

{{122484559__First Name}}


This code is made up of two pieces, the Node ID of the step where that information is received and the name of the field where the data is being sent. These two pieces are separated by two underscores.

You can get the Node ID from the URL of the Zap:


(view larger)

For example, using the Zap at this URL:

If we are trying to retrieve the field with a name of ‘Street Address’, the construction of this code will look like this:

{{122484559__Street Address}}

When the field is a key/value pair (like First Name: Steve), the key or field name can be used after double underscores, as shown in the example. 

In a case where the field is nested under another field (or multiple fields), each nest would be separated by double underscores. 

For example, if we were trying to retrieve the response for question 3 in the detail below:


The code would look like this:


If you need to extract a line-item array, use square brackets to separate the name of the array and the name of the field, as seen in the example below:


To extract the value in the field total of them all, the code would look like this:

{{90317686__line_items[]total of them all}}


Note: You cannot test custom pills inside the Zapier Editor.

Skip the action test and publish the Zap, then test with live data to ensure you are seeing the intended results in the Zap History.



A few tips regarding underscores and spaces:

  • If there are spaces in the field name, include those spaces in your code.

  • If the field name includes underscores, include these in your code as well. Be sure to use the correct number of underscores - if the field name has two underscores, your code should too.

15 replies

Userlevel 1

How should we extract similar elements fron an array. E.g. we have some array which has only one lineitem in sample data but there can be more in real data. Here’s how it looks:






When I copy element available from sample data for line item 1 I get “{{135274102__lineItems[]id}}”, there’s no lineitem number mentioned in element name. In your example I would want to get both quantity fields.

Userlevel 5

Hey @titsmaker, thanks for the question!

Referring back to my example, you would get both quantity fields by mapping `{{90317686__line_items[]quantity}}`. This pill mapping will deliver all line item values associated with that field name. Depending on the app you’re mapping it into, it will either appear as a string with all of the values separated by a comma, or can be further manipulated as an array. 

So for the array you’re working with, if you’d like to get the `lineItemId` values you can use the following: 



Hello @erinoz,


I tried your guide but unfortunately it’s not working.
My ZAP url:

I try to pull customfield_21133 in where I saw the value in the test:

Zap still says: 

this is the input i​​​​​​ used: {{146258814__customfield_21133}} and {{146258815__customfield_21133}}.

Can you support here?

Thanks & best,


Userlevel 7
Badge +11

Hey @Melanie Roever!

If the step you’re wanting to select the custom field from is the trigger step then you’ll likely want to use {{146258814__customfield_21133}} not {{146258815__customfield_21133}} - usually the node ID of the trigger step and Zap ID are the same).

It’s normal for the manually selected field to show as “No data” while in the Zap Editor. When the Zap is switched on and runs live, in the Zap history we should be able to see information coming through from that custom field though. Can you try turning the Zap on and trigger it to check that the information in the custom field is passed over correctly?

Userlevel 1

Hey Is there a limit on how many nested fields you can go down to?

I'm currently trying to use the below and its not pulling in anything


data looks like this in the trigger step


Userlevel 4
Badge +1

Hey Is there a limit on how many nested fields you can go down to?


Hi there! I have never encountered a layer, so I think that as long as you “target” the right child key, this should work.

It could be that you need to use:


Sometimes, it can be a little hard to figure out whether something is nested or it’s an array.

If more help is needed, please let us know:


This helped me out of a jam today thank you!

Userlevel 1



Is there a video/Youtube Link to this just to make it a bit more clear?

Userlevel 1

It helps me out. Thanks!

Userlevel 1

Hi @erinoz , I still don’t see precisely where I’m suppose to change the field name in the zap? Could you clarify please? A video walk through would be great if poss.


Userlevel 1

I am not getting a placeholding error.  

Userlevel 7
Badge +12

Hi @damonmanni!

If you aren’t seeing a placeholder error and are still having trouble with your Zap then it’s likely that something else is the cause. If you haven’t already, please could you create a new question about your Zap so that folks can more easily see that you need help. Thanks!



Assume if the zap ID is different to my node ID I should use the node ID, right? E.g





Userlevel 7
Badge +11

Hi @Clive_D!

I’m guessing you’ve likely already figured out the answer to your question here, but thought I’d hop in here to confirm that it’s the Node ID you should use. This is because the Node ID is what is used to indicate what trigger or action step the field is from. 

The Zap ID is the first ID number that appears in the Zap URL. And the second ID number in the Zap URL is the Node ID:

But what can be a little confusing, is that the Node ID for a trigger will be the same as the Zap ID. As shown in the example above, both numbers are the same so it technically makes no difference whether you copied the Zap ID or Node ID as they are the same number. But for referencing fields that are in other actions of the Zap you’d want to make sure you’re always using the Node ID for the action step that that field belongs to.

Hope that helps to clarify! 🙂

Hello, I am having trouble mapping over a custom field from click up that is a drop down type. 


I have tried various ways, but have yet to have my zap trigger successfully with these custom pill maps. 


For this example I have tried adding all of the possibilities I can think of and sill no luck.

I tried using a single custom code to map over the selected click up field (see below)


or {{197227214__name_Audiences__1}}

Also, I tried adding all of the possible options, like below: 




{{197227214__name_Audiences[]Sr. Manager/Manager}}


Yet, for some reason I get an error code in my Zap history:

Required field "Audience(s) (Custom Field)" (audience_s_1) is missing.


Please help!