# Application Integration: Field Mapping Panel

Source CRM fields on the left mapped to destination fields on the right, with transform badges, one unmapped row flagged, and a save footer.

- Page: https://www.shadcn-ui-blocks.com/blocks/application-pro/integrations/field-mapping-panel
- Collection: [Application](https://www.shadcn-ui-blocks.com/blocks/application-pro), Standard tier
- Group: [Integrations](https://www.shadcn-ui-blocks.com/blocks/application-pro/integrations)
- Created: 2026-07-04
- Preview image: https://www.shadcn-ui-blocks.com/blocks/application-pro/integrations/field-mapping-panel.png

## Install

```bash
npx shadcn@latest add @shadcn-ui-blocks/application-pro-integrations-field-mapping-panel
```

Needs an API key from a Pro or Team plan: add `@shadcn-ui-blocks` to the registries in components.json with the key as an `Authorization: Bearer` header. Setup: https://www.shadcn-ui-blocks.com/docs/shadcn-cli. The MCP server installs it without the setup: https://www.shadcn-ui-blocks.com/docs/mcp.

## Depends on

- npm packages: class-variance-authority, lucide-react, radix-ui
- shadcn/ui components: badge, button
- Installs to: `@/components/blocks/application-pro/integrations/field-mapping-panel`

## About this block

Field Mapping Panel is the sync configuration view for
a Salesforce to People integration: source fields on
the left (First Name, Email, Account Name, Phone, Lead
Source) each with a mono API path, an arrow across to a
select style destination control on the right, transform
badges where a value is reshaped (Lowercase, E.164
format), and one unmapped row (Lead Source) flagged with
a note on what happens to dropped values. The footer
carries Discard and Save mappings buttons and a line on
when changes apply.

Mappings are one const array with sourceLabel, sourceApi,
destination, transform, and mapped fields. The unmapped
warning is the honest detail: rather than hide the gap it
states that Lead Source values are dropped on every sync
until mapped, so nothing goes missing without a word.

## When to use

Reach for this block on an integration setup or edit
page, wired to your field schema and mapping API. Show
it after a user connects a source so they can confirm
which fields flow through before the first sync runs.

A natural flow around it on an Application Pro page:

**Before**

- [Sync status panel](https://www.shadcn-ui-blocks.com/blocks/application-pro/integrations)
- [Settings pages](https://www.shadcn-ui-blocks.com/blocks/application-pro/settings-pages)

**After**

- [Integration logs table](https://www.shadcn-ui-blocks.com/blocks/application-pro/integrations)
- [Data tables](https://www.shadcn-ui-blocks.com/blocks/application-pro/data-tables)

## What you can display

One strong use is the CRM contact field mapping. Other
mapping panels:

- **CSV import.** Uploaded columns mapped to your schema
  with a type guess per column.
- **Webhook payload.** Incoming JSON paths mapped to
  internal fields with a sample value preview.
- **Warehouse sync.** Source table columns mapped to
  model attributes with a null handling rule per row.

> Tip: always name what happens to unmapped values; a
> dropped field that fails silently becomes a data
> quality ticket weeks later.

## More in Application Integrations

- [Api Explorer Panel](https://www.shadcn-ui-blocks.com/blocks/application-pro/integrations/api-explorer-panel)
- [API Keys Panel](https://www.shadcn-ui-blocks.com/blocks/application-pro/integrations/api-keys-panel)
- [Api Usage Card](https://www.shadcn-ui-blocks.com/blocks/application-pro/integrations/api-usage-card)
- [API Version Panel](https://www.shadcn-ui-blocks.com/blocks/application-pro/integrations/api-version-panel)
- [Connected Accounts List](https://www.shadcn-ui-blocks.com/blocks/application-pro/integrations/connected-accounts-list)
- [Connected Services Status](https://www.shadcn-ui-blocks.com/blocks/application-pro/integrations/connected-services-status)
- [Github Repo Picker](https://www.shadcn-ui-blocks.com/blocks/application-pro/integrations/github-repo-picker)
- [Incoming Webhook Setup](https://www.shadcn-ui-blocks.com/blocks/application-pro/integrations/incoming-webhook-setup)
- [Integration Detail Panel](https://www.shadcn-ui-blocks.com/blocks/application-pro/integrations/integration-detail-panel)
- [Integration Health Card](https://www.shadcn-ui-blocks.com/blocks/application-pro/integrations/integration-health-card)
- [Integration Logs Table](https://www.shadcn-ui-blocks.com/blocks/application-pro/integrations/integration-logs-table)
- [Integration Marketplace](https://www.shadcn-ui-blocks.com/blocks/application-pro/integrations/integration-marketplace)
- [Integration Request Board](https://www.shadcn-ui-blocks.com/blocks/application-pro/integrations/integration-request-board)
- [Integration Setup Wizard](https://www.shadcn-ui-blocks.com/blocks/application-pro/integrations/integration-setup-wizard)
- [Integrations Gallery](https://www.shadcn-ui-blocks.com/blocks/application-pro/integrations/integrations-gallery)
- [IP Allowlist Panel](https://www.shadcn-ui-blocks.com/blocks/application-pro/integrations/ip-allowlist-panel)
- [Oauth Consent Blueprint](https://www.shadcn-ui-blocks.com/blocks/application-pro/integrations/oauth-consent-blueprint)
- [Oauth Scopes Review](https://www.shadcn-ui-blocks.com/blocks/application-pro/integrations/oauth-scopes-review)
- [Rate Limit Card](https://www.shadcn-ui-blocks.com/blocks/application-pro/integrations/rate-limit-card)
- [SDK Quickstart Panel](https://www.shadcn-ui-blocks.com/blocks/application-pro/integrations/sdk-quickstart-panel)
- [Slack Connect Panel](https://www.shadcn-ui-blocks.com/blocks/application-pro/integrations/slack-connect-panel)
- [Sync Conflict Resolver](https://www.shadcn-ui-blocks.com/blocks/application-pro/integrations/sync-conflict-resolver)
- [Sync Dry Run Preview](https://www.shadcn-ui-blocks.com/blocks/application-pro/integrations/sync-dry-run-preview)
- [Sync Status Panel](https://www.shadcn-ui-blocks.com/blocks/application-pro/integrations/sync-status-panel)
- [Webhook Settings Panel](https://www.shadcn-ui-blocks.com/blocks/application-pro/integrations/webhook-settings-panel)
- [Webhook Test Console](https://www.shadcn-ui-blocks.com/blocks/application-pro/integrations/webhook-test-console)
