Power Platform
What are connection references in Power Platform?
Quick answer
Connection references are solution-aware indirections: solution components reference a named slot, and each environment maps that slot to its own real connection. Without them, a flow hard-codes the maker’s personal connection and breaks — or worse, writes production data from Test — when moved across environments. They are the companion to environment variables: references rebind who/what system, variables rebind configuration values.
Key takeaways
- Named slots decouple solution logic from environment connections.
- Map slots per environment at import; automate with pipelines.
- Pair with service-owned connections, not personal accounts.
Detailed Explanation
Connection references are solution-aware indirections: solution components reference a named slot, and each environment maps that slot to its own real connection. Without them, a flow hard-codes the maker’s personal connection and breaks — or worse, writes production data from Test — when moved across environments. They are the companion to environment variables: references rebind who/what system, variables rebind configuration values.
How it works
Add the reference to the solution, point the flow actions at it, export managed, and on import map the slot to the target environment’s connection (ideally service-owned). Pipelines automate the mapping per stage.
Limitations and considerations
Every new connector needs its reference created and mapped — missed mappings are the top deployment failure. Owner-based personal connections still break on departures; pair references with service accounts.
For broader context, see the Power Platform Hub — it collects the guides around this topic.
When to use it
Use connection references in every solution-bound flow from day one; retrofitting them later means rewiring every action.
Practical example
An invoice flow’s SharePoint and Outlook actions point at references; deploying Test→Production rebinds both slots to production connections with zero flow edits.