I'm having trouble deploying an active in-app guidance via a change set (dev to partial). In the change set, i've selected 'Prompts' as what to deploy, and I've included the assets that I've used (images) in the steps. I've also activated In-App guidance in adoption settings in the target org.

I'm getting this error: "StepNumber fields in a walkthrough must range from 1 to the number of steps in the walkthrough." I have 6 steps in the walkthrough and I don't know what they mean by 'StepNumber' fields? Is there a setting I'm missing? Am I missing a component in my change set? Google has failed to provide the answer! Anyone?


This error comes directly from the API, and it's basically telling you that there's a missing number in the list of elements. This is stated in the documentation.

Required for walkthroughs only. Indicates the number of the last step the user viewed or interacted with in a walkthrough. Maximum of 10 steps. Numbers must be consecutive without repeated or skipped numbers. Available in API version 49.0 and later.


Thanks for the response. I dont even know where to look for the missing step number...I have 6 steps in the prompt...and they are consecutively numbered. the documentation isn't a help. I am looking at all of this in the UI and in change sets, not in vs code or anything. I rebuilt the walk through in the target sandbox and I am going to try to push it from there to the full sandbox. hopefully it will work! if not I dont know where to go next


This issue resolved when I deployed from our partial sandbox to our full sandbox and I was able to deploy it successfully. Since I manually recreated the guidance walkthrough in the partial sandbox, I suspect that while creating the prompt in our dev sandbox, I may have deleted a step, so that the metadata steps were out of order. I'm going to look into this further to satisfy my curiosity, and also, because the steps in metadata should reorder if you delete something---so that when you deploy you don't get the error. When I manually created it in par, I didn't delete any steps.

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service, privacy policy and cookie policy

Not the answer you're looking for? Browse other questions tagged or ask your own question.