How to Map Fields from Quote to Order in Salesforce Revenue Cloud?

Article Written By:
Anantharaman Veeraraghavan
Created On:

February 26, 2026

Mapping fields from Quote to Order in Salesforce Revenue Cloud using a Context Definition

In Salesforce Revenue Cloud, you map fields from a Quote to an Order through a Context Definition, not a direct object-to-object link. You add an attribute to the Sales Transaction Context, map your Quote field into it, then map that same attribute back out to the Order. Map the node first, then its attribute, and turn on both Input and Output. That one pattern drives the whole handoff.

Legacy Salesforce CPQ did this with matching 'twin fields' on both objects. Revenue Cloud drops that rule. The new model is a relief once it clicks, and a little confusing the first time you go looking for it.

This guide covers both halves. First, what Salesforce Revenue Cloud is and where it sits in quote-to-cash. Then the exact steps to map Quote-to-Order fields, with the attribute-tag detail, the map-the-node-first rule, the pricing-procedure step most walkthroughs skip, plus comparison tables, a Transaction Line Editor check, troubleshooting, and FAQs you can act on today.

What Is Salesforce Revenue Cloud?

Salesforce Revenue Cloud is Salesforce's platform for running the entire revenue lifecycle on one data model, from the first quote to cash in the bank. You'll also see it written as revenue cloud salesforce, Salesforce Revenue Lifecycle Management, or just Revenue Lifecycle Management (RLM). Same platform, different labels.

It pulls the moving parts of Salesforce Revenue Management into one flow: configure, price, quote; contracts; orders; billing; and subscriptions. Old orgs stitch those steps together with custom code and nightly syncs. Revenue Cloud links them on shared objects instead.

The newest tier is Salesforce Revenue Cloud Advanced. It's rebuilt on core platform objects like Sales Transaction. Those are the same objects you'll map against below, so the 'what is it' and the 'how do I do it' sit close together. If your team is weighing a move onto this model, our Revenue Cloud implementation team plans the data model before a single field gets touched.

Salesforce Revenue Cloud vs. Legacy Salesforce CPQ

If your team grew up on Salesforce CPQ, this shift matters. Classic CPQ was a managed package bolted onto the platform. Revenue Cloud Advanced is native to it. That one change reshapes how data moves. It also changes how much upkeep you sign up for.

Here's how the two stack up across the factors that matter most:

Factor Legacy Salesforce CPQ Revenue Cloud Advanced
Architecture Managed package bolted onto the platform Native, built on core platform objects
Field mapping method "Twin fields" with matching API names on both objects Context Definition attributes, mapped in and out
Data model Quote and Order objects specific to the package Shared Sales Transaction objects
Ongoing upkeep Package upgrades and twin-field drift Config-driven, fewer moving parts
AI / Agentforce Not built in Native path to Agentforce Revenue Management
Best for Existing CPQ orgs still in production New builds and re-engineered revenue orgs

For a wider view of how the two products compare, Salesforce Ben's coverage of Revenue Cloud and CPQ is a useful read.

Moving an existing CPQ org onto this model is its own project, which is where legacy CPQ migration support earns its keep.

The Salesforce Quote-to-Cash Lifecycle in Revenue Cloud

Salesforce quote-to-cash is the path a deal takes from a priced quote to recognized revenue. Revenue Cloud runs each stage on the same platform, so data isn't re-keyed at every handoff. That's the payoff of the shared-object model.

Here's how the stages line up, and where the Quote-to-Order step you're mapping actually lives:

  • Configure, price, quote - build and price the deal for the customer. Key object: Quote and Quote Line.
  • Order - turn the accepted quote into a fulfillable order. Key object: Order and Order Product.
  • Billing - turn the order into invoices and collect payment. Key object: Invoice.
  • Subscription and assets - track renewals, amendments, and churn risk. Key object: Asset.
  • Revenue analytics - report on MRR, ARR, and revenue health. Key object: analytics dashboards.

Mapping fields from Quote to Order is the second handoff in that chain. Get it right and every stage after it inherits clean data.

Revenue Cloud Billing and Subscription Management

Three capabilities carry the back half of quote-to-cash, and each one leans on the same clean handoff you're setting up.

Advanced Salesforce Revenue Cloud Billing turns active orders and subscriptions into invoices without manual re-entry. If an Order field arrives blank because a mapping was missed, that gap follows the record straight onto the invoice.

Salesforce subscription management tracks each sold asset across its life - renewals, upgrades, downgrades, and cancellations - so recurring revenue stays accurate as customers change plans.

Salesforce billing automation ties it together. Usage and schedule data flow from the order to billing on a set cadence, so finance isn't rebuilding invoices by hand every cycle. Wiring Revenue Cloud to billing and fulfillment cleanly is an integration architecture job. Clean field mapping upstream is what keeps that automation honest.

How Agentforce Revenue Management Changes Revenue Cloud

Worth knowing up front: Salesforce is renaming Revenue Cloud to Agentforce Revenue Management, folding AI agents into quoting, contracts, and order workflows.

The name is changing. The mechanics in this guide are not. Context Definitions, Sales Transactions, and entity mapping all work exactly as described here, whichever label shows up in your org's Setup menu.

Context Definitions 101: The Engine Behind Quote-to-Order Data

Field values don't travel straight from a Quote to an Order. They pass through a context layer:

Quote (Source) → Sales Transaction Context → Order (Target)

Two mapping actions happen. First, the Quote field goes into a shared attribute. Then that attribute goes out to the Order field. Learn it once and every future mapping follows the same shape. Salesforce's own developer documentation on Context Definitions covers the Sales Transaction data model if you want to go deeper.

Twin Fields (Legacy CPQ) vs. Context Definitions (Revenue Cloud)

The naming rule is the biggest change to unlearn. Here's the side-by-side:

Aspect Twin Fields (Legacy CPQ) Context Definitions (Revenue Cloud)
How data moves Field copies directly to its twin Field flows through a shared attribute
Naming rule API names must match on both objects Names can differ; a tag links them
What you build Matching fields on both objects An attribute and tag on the Sales Transaction node
Direction control Implicit, one-way copy Explicit Input and Output toggles
Where it breaks Mismatched API names Unmapped node, missing tag, or pricing procedure

Map the Node Before You Map the Attribute

One rule trips up almost every first-time setup: map the node before you map its attributes. In both Quote Entities Mapping and Order Entities Mapping, the node (Sales Transaction or Sales Transaction Item) has to be mapped first. Only then will its attributes accept a source or target.

Skip the node and the attribute row looks selectable but never saves a value. If your mapping seems to 'not stick,' check that the node above it is mapped first.

Header-Level vs. Line-Level Mapping

There are two mapping levels, and each one uses a different context node:

DetailHeader-LevelLine-LevelContext nodeSales TransactionSales Transaction ItemSource objectQuoteQuote LineTarget objectOrderOrder ProductExample fieldRequested Delivery DateLine Configuration NotesCommon mistakeMapping a line field on the header nodeMapping a header field on the item node

Pick the wrong node and nothing throws an error - the field just stays empty. That silent miss is the single most common cause of a 'mapping didn't work' ticket.

Why Input and Output Both Matter

Each attribute has an Input setting and an Output setting. Input pulls a value in from the source. Output pushes it back out to the target. Turn on both, or data flows one way and stops.

The Setup screen can read backward the first time. When you map Quote Entities, the arrow can look like it runs from the Sales Transaction to the Quote. Enabling both Input and Output is what lets the value move in the direction you actually want. If a field fills in once and never refreshes, this setting is usually the reason.

Prerequisites Checklist Before You Map Fields

  • Matching custom fields on both the Quote (or Quote Line) and the Order (or Order Product). Names can differ; data types shouldn't.
  • An active Context Definition - a cloned or extended version of the standard Sales Transaction definition, never the standard one directly.
  • The right definition set in Revenue Settings. Extending a Context Definition isn't enough. Your org has to point at that extended version in Revenue Settings, or your new mapping never runs.
  • The extended context wired into your pricing procedure. This is the step that breaks the most first-time setups. More on it below.
  • A sandbox. Build and test every mapping there first. One bad mapping can quietly block Quote-to-Order conversion across the whole org. Salesforce's admin best practices for testing config changes make the same case before anything ships.

Step-by-Step: Map a Header-Level Field (Quote to Order)

This example maps a Requested Delivery Date field from Quote to Order.

  1. In Setup, open Context Definitions and edit your active Sales Transaction definition.
  2. Under Structure, select the Sales Transaction node and add a new Attribute named Requested Delivery Date. Match the attribute's data type to your field.
  3. Open the Attribute Tags page, find your attribute, and click Add Tag. Give it a clear, unique tag (for example, Requested_Delivery_Date). The tag is the internal handle the mapping points at, so keep it readable. This is the step most quick guides gloss over.
  4. Turn on both Input and Output on the attribute, then save.
  5. Open Map Data → Quote Entities Mapping. Map the Sales Transaction node first, then set the Quote's Requested Delivery Date field as the source and your new attribute as the target. Save and Publish.
  6. Open Map Data → Order Entities Mapping. Map the node first here too, then set the attribute as the source and the Order's Requested Delivery Date field as the target. Save and Publish.
  7. Activate the Context Definition.
  8. Test it: create a Quote, fill in the date, convert to an Order, and confirm the value lands. Then edit the Quote before conversion and confirm updates still carry through.

Step-by-Step: Map a Line-Level Field (Quote Line to Order Product)

Line-item detail - like Line Configuration Notes on a configured product — rides through the Sales Transaction Item node instead of Sales Transaction. The shape is the same; only the node changes.

  1. Create the matching custom field on both Quote Line and Order Product, with the same data type.
  2. In your active Context Definition, select the Sales Transaction Item node under Structure and add the attribute. Tag it on the Attribute Tags page, then enable Input and Output.
  3. In Quote Entities Mapping, map the Sales Transaction Item node (not the header) first, then map the Quote Line field to the attribute. Save and Publish.
  4. In Order Entities Mapping, map the node, then map the attribute to the Order Product field. Save and Publish.
  5. Activate, then test with a Quote that has at least one Quote Line and confirm the value lands on the matching Order Product.

Confirm the Field in the Transaction Line Editor First

Before you convert anything, check the Transaction Line Editor (TLE). This is the pricing surface Revenue Cloud uses on the Quote, and a mapped attribute has to persist there before it can flow onward.

Open a Quote, launch the Transaction Line Editor, and confirm your custom value holds after a reprice. If it clears when the TLE recalculates, the attribute isn't wired into the pricing procedure yet - which is the exact step below. A value that survives the TLE will survive the conversion.

The Step Most Guides Miss: Point Your Pricing Procedure at the Extended Context

Here's the one that fills support forums. You extend the Sales Transaction Context, map both sides, activate, convert — and the field still shows up blank. The mapping is fine. The problem is elsewhere.

Revenue Cloud runs your Context Definition through the pricing procedure during conversion. If that pricing procedure still references the standard Sales Transaction Context instead of your extended one, your new attribute never gets read. Setting the extended definition in Revenue Settings is only half the wiring.

Open your default pricing procedure and confirm it points at the same extended Context Definition you mapped against. Community threads on this exact symptom keep landing on the same fix — the Trailblazer Community threads on quote-to-order mapping repeat it in thread after thread. Check this before you re-map anything.

The same idea applies when you reprice an order. If a custom tag isn't mapped in Order Entities Mapping for every procedure that touches the order, repricing can throw an error. Map the tag everywhere the pricing procedure expects it, not just on the first pass. Keeping hundreds of these mappings stable across releases is where our release governance and Managed Services team does its steady work.

How to Convert a Quote to an Order and Check the Mapping

Mapping and conversion are two different actions, and it helps to see them together.

To convert, open an accepted Quote that has at least one Quote Line and click Create Order. Revenue Cloud spins up the Order and its Order Products, running your Context Definition as it goes. Open the new Order and confirm each mapped field — header and line — carries the value from the Quote.

If a value is missing, don't re-map yet. Check the node mapping, the Input/Output toggle, the active definition in Revenue Settings, and the pricing procedure reference first. That short list clears most conversion misses.

Map Fields Further Downstream: Order to Asset

Plenty of teams need a value to travel past the Order — from Quote Line to Order Product to Asset, and on to Asset State. The pattern holds, but the mapping objects change.

Propagating a field all the way to the asset lifecycle uses dedicated maps like AssetStatePrdToSalesTxnItmMap and AssetToSalesTransactionMapping. Set up the Quote-to-Order hop first and confirm it works, then extend the same attribute downstream one object at a time. Testing each hop on its own tells you exactly where a value stops flowing.

Troubleshooting: When the Mapped Field Doesn't Show Up

Most 'mapping didn't work' tickets trace back to one of these causes:

Symptom Likely Cause Fix
Field stays blank after conversion Pricing procedure points at the standard context Point the pricing procedure at your extended Context Definition
Attribute row won't save a value Node wasn't mapped first Map the Sales Transaction / Item node, then the attribute
Header field empty, line field fine (or vice versa) Wrong context node Sales Transaction for header, Sales Transaction Item for lines
Value fills once, never updates Only Input or only Output enabled Turn on both Input and Output on the attribute
Mapping ignored entirely Wrong definition set in Revenue Settings Set Revenue Settings to your extended definition
Value clears in the Transaction Line Editor Attribute not read by the pricing procedure Wire the extended context into the pricing procedure
Repricing an order throws an error Tag missing from a procedure that touches the order Map the tag in Order Entities Mapping for every relevant procedure
Nothing flows to the Asset Downstream asset maps not set Add AssetStatePrdToSalesTxnItmMap / AssetToSalesTransactionMapping


Frequently Asked Questions

1. What is Salesforce Revenue Cloud?

Salesforce Revenue Cloud is Salesforce's platform for running the full revenue lifecycle — quote, order, billing, and subscriptions — on one shared data model. It's also called Salesforce Revenue Lifecycle Management, and its native tier is Revenue Cloud Advanced.

2. How do I map fields from Quote to Order in Salesforce Revenue Cloud?

Create an attribute on the Sales Transaction Context Definition, tag it, and enable Input and Output. Map the node first, set your Quote field as the source, then map that attribute to your Order field as the target. Activate the definition to go live.

3. How do I convert a Quote to an Order in Salesforce?

Open an accepted Quote with at least one Quote Line and click Create Order. Revenue Cloud creates the Order and Order Products and runs your active Context Definition, carrying mapped values across as it builds the record.

4. How do I check field mapping in Salesforce Revenue Cloud?

Open your active Context Definition and review Quote Entities Mapping and Order Entities Mapping for the attribute. Confirm the value holds in the Transaction Line Editor, then convert a test Quote and confirm it lands on the Order. If it doesn't, check the node, Input/Output, Revenue Settings, and the pricing procedure reference.

5. What's the difference between a quote and an order in Salesforce?

A quote is the priced proposal you send a customer; an order is the accepted, fulfillable commitment created once they say yes. In Revenue Cloud, converting the quote creates the order and copies mapped field values across.

6. Is Salesforce Revenue Cloud replacing Salesforce CPQ?

Revenue Cloud Advanced is the native successor to the classic Salesforce CPQ managed package. Existing CPQ orgs still run, but new field mapping moves from twin fields to Context Definitions.

7. Does Salesforce Revenue Cloud include billing and subscription management?

Yes. Salesforce Revenue Cloud Billing and subscription management sit downstream of the order, turning mapped order data into invoices and tracking each asset through renewals and changes.

8. Does Revenue Cloud support line-level field mapping?

Yes, through the Sales Transaction Item node - used for Quote Line to Order Product mapping, separate from the header-level Sales Transaction node.

9. Does any of this change once Revenue Cloud becomes Agentforce Revenue Management?

No. The rebrand changes the product name only. Context Definitions and entity mapping work exactly as described here either way.

Engineer This Once, Not Every Release - Partner With Minuscule Technologies

A single field mapping is a five-minute task. Keeping hundreds of them stable is a different job. They have to survive every release, product change, and org migration — and that's the one we do. At Minuscule Technologies, we act as your Salesforce engineering partner across the full quote-to-cash lifecycle. That runs from Context Definition design to pricing-procedure wiring and release governance.

Ready to stop chasing manual re-entry between Quote and Order? Talk to our Revenue Cloud team about a governed, release-proof field-mapping setup.

Contact Us for Free Consultation
Thank you! We will get back in touch with you within 48 hours.
Oops! Something went wrong while submitting the form.

Recent Blogs

Ready to Architect Your Salesforce Success?

You've seen what's possible. Now, let's make it happen for your business. Whether you need an end-to-end Salesforce solution, a complex integration, or ongoing managed services, our team is ready to deliver.

Schedule a Free Strategic Call