The Customer section has three tabs: Customer Sync Rules, Customer Default Mappings, and Customer Field Mappings. Work through each tab and click Save before moving to the next.
Customer Sync Rules
When an order is placed in WooCommerce, the integration searches for the matching customer in Xero before creating an invoice. This tab tells it how to do that search.
Customer Matching Criteria
You select one field from WooCommerce and one field from Xero. The integration compares the two values — if they match, the existing Xero contact is used. If no match is found, a new contact is created automatically.Why this matters: If the integration cannot reliably identify your customers, it will create duplicate contacts in Xero. Duplicate contacts lead to messy records, reconciliation issues, and inaccurate invoicing history.Which field to choose: Email address is the most reliable option. It is unique per customer and almost always filled in on a WooCommerce order. Fields like first name are not unique — two customers named “John” will cause a mismatch.
The WooCommerce field you select must not be empty on orders. If the field is blank, the integration cannot search for a match and will trigger an error.
Contact ID / Account Number
When the integration creates a new customer in Xero, Xero assigns that contact a unique ID. This setting controls two things: who generates the ID, and whether it is stored back in WooCommerce.Let Xero create the contact ID is the recommended option. Xero auto-generates a unique identifier and you can optionally select a WooCommerce field to save it in. Storing the Xero contact ID in WooCommerce makes future matching faster and more reliable.If you do not need to store it, select Do not add it anywhere.Click Save before continuing.
Customer Default Mappings
This tab sets the default values applied when the integration creates a new customer record in Xero. These defaults fill in required Xero fields that may not exist on a WooCommerce customer record.Why this matters: Xero requires certain fields to be populated when creating a contact — for example, currency and tax rate. If these are left unconfigured, new customer records may be created with incorrect or missing accounting information, which causes problems when processing payments or filing tax returns.Set each field to match your Xero account configuration:
Setting
What to set
Currency
The currency your store trades in
Sales default amounts
Whether your prices are tax inclusive or exclusive — match your Xero pricing setup
Branding theme
The invoice or quote template applied in Xero
Invoice due date
How many days after the invoice date payment is expected
Sales tax
The tax rate that applies to your sales
Sales account
The Xero account code where sales revenue is recorded
Click Save before continuing.
Customer Field Mappings
This tab controls exactly which WooCommerce customer fields are transferred to Xero when a new contact is created. Each row maps one Xero contact field to a WooCommerce field.Why this matters: The more accurately your customer data is mapped, the less manual correction is needed in Xero. Incomplete mappings mean your Xero contacts may be missing names, addresses, or contact details — making it harder to send invoices.Fields are organised into four groups: General, Billing Address, Delivery Address, and Additional.
Contact Name is mandatory and must be mapped. Without it, Xero cannot create a valid contact record. Some fields are pre-mapped by default — you can edit or delete any mapping to suit your requirements.
Fields showing Not Mapped will not be transferred to Xero. To add a mapping, click Edit next to the relevant Xero field and select the corresponding WooCommerce field.Click Save Mappings when finished.
Was this page helpful?
{"docsConfig":{"theme":"aspen","$schema":"https://mintlify.com/docs.json","name":"Cloudify Documentation","colors":{"primary":"#1a73e8","light":"#E5F2FF","dark":"#1a73e8"},"logo":{"light":"https://mintcdn.com/cloudify-c7720744/Ie43f-kQkw_inATF/images/cloudify_kb_light.svg?fit=max\u0026auto=format\u0026n=Ie43f-kQkw_inATF\u0026q=85\u0026s=e6fee15c45d046196122c85fc772f27f","dark":"https://mintcdn.com/cloudify-c7720744/Ie43f-kQkw_inATF/images/cloudify_kb_dark.svg?fit=max\u0026auto=format\u0026n=Ie43f-kQkw_inATF\u0026q=85\u0026s=e7912f98f52179439d72e912f32f1ee9","href":"/index"},"favicon":"https://mintcdn.com/cloudify-c7720744/yZ6OL23tlT3UIKur/images/cloudify-favicon.png?fit=max\u0026auto=format\u0026n=yZ6OL23tlT3UIKur\u0026q=85\u0026s=e285cca1f639970421f792349055c52c","appearance":{"default":"system"},"background":{"decoration":"gradient"},"navbar":{"links":[{"href":"mailto:support@cloudify.biz","label":"Support"}],"primary":{"type":"button","label":"Book a free consultation","href":"https://meetings.hubspot.com/cloudify/app-assistance"}},"footer":{"socials":{"linkedin":"https://linkedin.com/company/cloudify","facebook":"https://www.facebook.com/cloudify.biz","x":"https://x.com/cloudify_biz"}},"contextual":{"options":["copy","view"],"display":"header"},"markdown":{"schema":true},"styling":{"latex":true},"navigation":{"global":{"anchors":[{"anchor":"Home","icon":"house","href":"/"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"cloudify-c7720744","hasAudioNarration":false,"actualSubdomain":"cloudify-c7720744","customDomains":["docs.cloudify.biz"],"gitSource":{"type":"github","owner":"cloudifybiz","repo":"setup-guide-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{},"buildId":"6af2c5b59ee930ea29ae6503","clientVersion":"0.0.4167","searchFilterCounts":[{"language":"default","tag":"Setup Guide","count":212},{"language":"default","tag":"Configuration","count":88},{"language":"default","tag":"Installation","count":80},{"language":"default","tag":"Get the Most Out of the App","count":40},{"language":"default","tag":"Getting Started","count":36},{"language":"default","tag":"HubSpot Xero Integration","count":22},{"language":"default","tag":"Getting-Started","count":21},{"language":"default","tag":"HubSpot e-conomic Integration","count":18},{"language":"default","tag":"Pipedrive Xero Integration","count":17},{"language":"default","tag":"HubSpot Fortnox Integration","count":16}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"woocommerce/woocommerce-xero/configuration/customer-search-rules-1","slug":"/woocommerce/woocommerce-xero/configuration/customer-search-rules-1","pageMetadata":{"title":"Customer Search Rules","description":null,"href":"/woocommerce/woocommerce-xero/configuration/customer-search-rules-1"},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={hr:`hr`,p:`p`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{Frame,Heading,Note,OptimizedImage,Table,Warning}=_components;if(!Frame)_missingMdxReference(`Frame`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`The Customer section has three tabs: `,_jsx(_components.strong,{children:`Customer Sync Rules`}),`, `,_jsx(_components.strong,{children:`Customer Default Mappings`}),`, and `,_jsx(_components.strong,{children:`Customer Field Mappings`}),`. Work through each tab and click `,_jsx(_components.strong,{children:`Save`}),` before moving to the next.`]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`customer-sync-rules`,children:`Customer Sync Rules`}),`\n`,_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/cloudify-c7720744/3Frzbbzb2uveq_Jz/images/Screenshot-2026-06-24-211754.jpeg?fit=max\u0026auto=format\u0026n=3Frzbbzb2uveq_Jz\u0026q=85\u0026s=b601e8506aabbbb500577fbec6331d03`,alt:`Screenshot 2026 06 24 211754`,\"data-og-width\":`1225`,width:`1225`,\"data-og-height\":`745`,height:`745`,\"data-path\":`images/Screenshot-2026-06-24-211754.jpeg`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/cloudify-c7720744/3Frzbbzb2uveq_Jz/images/Screenshot-2026-06-24-211754.jpeg?w=280\u0026fit=max\u0026auto=format\u0026n=3Frzbbzb2uveq_Jz\u0026q=85\u0026s=ecf5fb87d4eaf2d5272384cfecf61ebf 280w, https://mintcdn.com/cloudify-c7720744/3Frzbbzb2uveq_Jz/images/Screenshot-2026-06-24-211754.jpeg?w=560\u0026fit=max\u0026auto=format\u0026n=3Frzbbzb2uveq_Jz\u0026q=85\u0026s=fd49c5b2c117428b314036e21c2fcfe3 560w, https://mintcdn.com/cloudify-c7720744/3Frzbbzb2uveq_Jz/images/Screenshot-2026-06-24-211754.jpeg?w=840\u0026fit=max\u0026auto=format\u0026n=3Frzbbzb2uveq_Jz\u0026q=85\u0026s=b4040459cbb67e113b1efd157eca6408 840w, https://mintcdn.com/cloudify-c7720744/3Frzbbzb2uveq_Jz/images/Screenshot-2026-06-24-211754.jpeg?w=1100\u0026fit=max\u0026auto=format\u0026n=3Frzbbzb2uveq_Jz\u0026q=85\u0026s=a5b418087d29f2634f5656de9ec4f6ad 1100w, https://mintcdn.com/cloudify-c7720744/3Frzbbzb2uveq_Jz/images/Screenshot-2026-06-24-211754.jpeg?w=1650\u0026fit=max\u0026auto=format\u0026n=3Frzbbzb2uveq_Jz\u0026q=85\u0026s=cc7549829f174ef1a0ad31666bbd5cb2 1650w, https://mintcdn.com/cloudify-c7720744/3Frzbbzb2uveq_Jz/images/Screenshot-2026-06-24-211754.jpeg?w=2500\u0026fit=max\u0026auto=format\u0026n=3Frzbbzb2uveq_Jz\u0026q=85\u0026s=74f03372d12db0347aaf0f5788edc4b3 2500w`})}),`\n`,_jsx(_components.p,{children:`When an order is placed in WooCommerce, the integration searches for the matching customer in Xero before creating an invoice. This tab tells it how to do that search.`}),`\n`,_jsx(Heading,{level:`3`,id:`customer-matching-criteria`,children:`Customer Matching Criteria`}),`\n`,_jsx(_components.p,{children:`You select one field from WooCommerce and one field from Xero. The integration compares the two values — if they match, the existing Xero contact is used. If no match is found, a new contact is created automatically.`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Why this matters:`}),` If the integration cannot reliably identify your customers, it will create duplicate contacts in Xero. Duplicate contacts lead to messy records, reconciliation issues, and inaccurate invoicing history.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Which field to choose:`}),` Email address is the most reliable option. It is unique per customer and almost always filled in on a WooCommerce order. Fields like first name are not unique — two customers named “John” will cause a mismatch.`]}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`The WooCommerce field you select must not be empty on orders. If the field is blank, the integration cannot search for a match and will trigger an error.`})}),`\n`,_jsx(Heading,{level:`3`,id:`contact-id-/-account-number`,children:`Contact ID / Account Number`}),`\n`,_jsx(_components.p,{children:`When the integration creates a new customer in Xero, Xero assigns that contact a unique ID. This setting controls two things: who generates the ID, and whether it is stored back in WooCommerce.`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Let Xero create the contact ID`}),` is the recommended option. Xero auto-generates a unique identifier and you can optionally select a WooCommerce field to save it in. Storing the Xero contact ID in WooCommerce makes future matching faster and more reliable.`]}),`\n`,_jsxs(_components.p,{children:[`If you do not need to store it, select `,_jsx(_components.strong,{children:`Do not add it anywhere`}),`.`]}),`\n`,_jsxs(_components.p,{children:[`Click `,_jsx(_components.strong,{children:`Save`}),` before continuing.`]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`customer-default-mappings`,children:`Customer Default Mappings`}),`\n`,_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/cloudify-c7720744/3Frzbbzb2uveq_Jz/images/Screenshot-2026-06-24-211954.jpeg?fit=max\u0026auto=format\u0026n=3Frzbbzb2uveq_Jz\u0026q=85\u0026s=eface746757527418420140e48a6697f`,alt:`Screenshot 2026 06 24 211954`,\"data-og-width\":`1068`,width:`1068`,\"data-og-height\":`580`,height:`580`,\"data-path\":`images/Screenshot-2026-06-24-211954.jpeg`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/cloudify-c7720744/3Frzbbzb2uveq_Jz/images/Screenshot-2026-06-24-211954.jpeg?w=280\u0026fit=max\u0026auto=format\u0026n=3Frzbbzb2uveq_Jz\u0026q=85\u0026s=c122db4453e197445dcaf8dbc07e1590 280w, https://mintcdn.com/cloudify-c7720744/3Frzbbzb2uveq_Jz/images/Screenshot-2026-06-24-211954.jpeg?w=560\u0026fit=max\u0026auto=format\u0026n=3Frzbbzb2uveq_Jz\u0026q=85\u0026s=29a61cfe4ede8a96f51d74289e4de7d6 560w, https://mintcdn.com/cloudify-c7720744/3Frzbbzb2uveq_Jz/images/Screenshot-2026-06-24-211954.jpeg?w=840\u0026fit=max\u0026auto=format\u0026n=3Frzbbzb2uveq_Jz\u0026q=85\u0026s=1544b780b86c11442b38a78e23ee6dd7 840w, https://mintcdn.com/cloudify-c7720744/3Frzbbzb2uveq_Jz/images/Screenshot-2026-06-24-211954.jpeg?w=1100\u0026fit=max\u0026auto=format\u0026n=3Frzbbzb2uveq_Jz\u0026q=85\u0026s=6baf5d4fbfd47d50d18bf4be49aad871 1100w, https://mintcdn.com/cloudify-c7720744/3Frzbbzb2uveq_Jz/images/Screenshot-2026-06-24-211954.jpeg?w=1650\u0026fit=max\u0026auto=format\u0026n=3Frzbbzb2uveq_Jz\u0026q=85\u0026s=b2ff176a7c81561cc8cbd162f5948d3d 1650w, https://mintcdn.com/cloudify-c7720744/3Frzbbzb2uveq_Jz/images/Screenshot-2026-06-24-211954.jpeg?w=2500\u0026fit=max\u0026auto=format\u0026n=3Frzbbzb2uveq_Jz\u0026q=85\u0026s=29c7b9c2d17b185e697bca2c69e58e29 2500w`})}),`\n`,_jsx(_components.p,{children:`This tab sets the default values applied when the integration creates a new customer record in Xero. These defaults fill in required Xero fields that may not exist on a WooCommerce customer record.`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Why this matters:`}),` Xero requires certain fields to be populated when creating a contact — for example, currency and tax rate. If these are left unconfigured, new customer records may be created with incorrect or missing accounting information, which causes problems when processing payments or filing tax returns.`]}),`\n`,_jsx(_components.p,{children:`Set each field to match your Xero account configuration:`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Setting`}),_jsx(_components.th,{children:`What to set`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Currency`}),_jsx(_components.td,{children:`The currency your store trades in`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Sales default amounts`}),_jsx(_components.td,{children:`Whether your prices are tax inclusive or exclusive — match your Xero pricing setup`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Branding theme`}),_jsx(_components.td,{children:`The invoice or quote template applied in Xero`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Invoice due date`}),_jsx(_components.td,{children:`How many days after the invoice date payment is expected`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Sales tax`}),_jsx(_components.td,{children:`The tax rate that applies to your sales`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Sales account`}),_jsx(_components.td,{children:`The Xero account code where sales revenue is recorded`})]})]})]}),`\n`,_jsxs(_components.p,{children:[`Click `,_jsx(_components.strong,{children:`Save`}),` before continuing.`]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`customer-field-mappings`,children:`Customer Field Mappings`}),`\n`,_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/cloudify-c7720744/3Frzbbzb2uveq_Jz/images/Screenshot-2026-06-24-212100.jpeg?fit=max\u0026auto=format\u0026n=3Frzbbzb2uveq_Jz\u0026q=85\u0026s=8fa19871bc25daab91f54d3543a62ed2`,alt:`Screenshot 2026 06 24 212100`,\"data-og-width\":`1027`,width:`1027`,\"data-og-height\":`814`,height:`814`,\"data-path\":`images/Screenshot-2026-06-24-212100.jpeg`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/cloudify-c7720744/3Frzbbzb2uveq_Jz/images/Screenshot-2026-06-24-212100.jpeg?w=280\u0026fit=max\u0026auto=format\u0026n=3Frzbbzb2uveq_Jz\u0026q=85\u0026s=982d1fbc94546841faf0640f790b3c07 280w, https://mintcdn.com/cloudify-c7720744/3Frzbbzb2uveq_Jz/images/Screenshot-2026-06-24-212100.jpeg?w=560\u0026fit=max\u0026auto=format\u0026n=3Frzbbzb2uveq_Jz\u0026q=85\u0026s=d725b9a46d98856a02e45afbac417626 560w, https://mintcdn.com/cloudify-c7720744/3Frzbbzb2uveq_Jz/images/Screenshot-2026-06-24-212100.jpeg?w=840\u0026fit=max\u0026auto=format\u0026n=3Frzbbzb2uveq_Jz\u0026q=85\u0026s=05aa4d9f7f4a9bf4b65d657214edda2b 840w, https://mintcdn.com/cloudify-c7720744/3Frzbbzb2uveq_Jz/images/Screenshot-2026-06-24-212100.jpeg?w=1100\u0026fit=max\u0026auto=format\u0026n=3Frzbbzb2uveq_Jz\u0026q=85\u0026s=4e7f45ec1caba71cac85e8624cc9c223 1100w, https://mintcdn.com/cloudify-c7720744/3Frzbbzb2uveq_Jz/images/Screenshot-2026-06-24-212100.jpeg?w=1650\u0026fit=max\u0026auto=format\u0026n=3Frzbbzb2uveq_Jz\u0026q=85\u0026s=2aeb59c024742d21f840b74276744ef0 1650w, https://mintcdn.com/cloudify-c7720744/3Frzbbzb2uveq_Jz/images/Screenshot-2026-06-24-212100.jpeg?w=2500\u0026fit=max\u0026auto=format\u0026n=3Frzbbzb2uveq_Jz\u0026q=85\u0026s=ae391a4a9f32558abb8687e7b770db47 2500w`})}),`\n`,_jsx(_components.p,{children:`This tab controls exactly which WooCommerce customer fields are transferred to Xero when a new contact is created. Each row maps one Xero contact field to a WooCommerce field.`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Why this matters:`}),` The more accurately your customer data is mapped, the less manual correction is needed in Xero. Incomplete mappings mean your Xero contacts may be missing names, addresses, or contact details — making it harder to send invoices.`]}),`\n`,_jsxs(_components.p,{children:[`Fields are organised into four groups: `,_jsx(_components.strong,{children:`General`}),`, `,_jsx(_components.strong,{children:`Billing Address`}),`, `,_jsx(_components.strong,{children:`Delivery Address`}),`, and `,_jsx(_components.strong,{children:`Additional`}),`.`]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Contact Name`}),` is mandatory and must be mapped. Without it, Xero cannot create a valid contact record. Some fields are pre-mapped by default — you can edit or delete any mapping to suit your requirements.`]})}),`\n`,_jsxs(_components.p,{children:[`Fields showing `,_jsx(_components.strong,{children:`Not Mapped`}),` will not be transferred to Xero. To add a mapping, click `,_jsx(_components.strong,{children:`Edit`}),` next to the relevant Xero field and select the corresponding WooCommerce field.`]}),`\n`,_jsxs(_components.p,{children:[`Click `,_jsx(_components.strong,{children:`Save Mappings`}),` when finished.`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Customer Search Rules","description":null,"href":"/woocommerce/woocommerce-xero/configuration/customer-search-rules-1"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Customer Sync Rules","slug":"customer-sync-rules","depth":2,"children":[{"title":"Customer Matching Criteria","slug":"customer-matching-criteria","depth":3,"children":[]},{"title":"Contact ID / Account Number","slug":"contact-id-/-account-number","depth":3,"children":[]}]},{"title":"Customer Default Mappings","slug":"customer-default-mappings","depth":2,"children":[]},{"title":"Customer Field Mappings","slug":"customer-field-mappings","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"cloudify-c7720744","siteName":"Cloudify Documentation","title":"Customer Search Rules - Cloudify Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-01T09:00:33.122Z","originalFileLocation":"woocommerce/woocommerce-xero/configuration/customer-search-rules-1.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"application-name\" content=\"Cloudify Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/cloudify-c7720744/6Hmx_AJUh5PJc53T/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/cloudify-c7720744/6Hmx_AJUh5PJc53T/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/cloudify-c7720744/6Hmx_AJUh5PJc53T/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/cloudify-c7720744/6Hmx_AJUh5PJc53T/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/cloudify-c7720744/6Hmx_AJUh5PJc53T/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/cloudify-c7720744/6Hmx_AJUh5PJc53T/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/cloudify-c7720744/6Hmx_AJUh5PJc53T/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/cloudify-c7720744/6Hmx_AJUh5PJc53T/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/cloudify-c7720744/6Hmx_AJUh5PJc53T/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Customer Search Rules - Cloudify Documentation\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Cloudify Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.cloudify.biz/woocommerce/woocommerce-xero/configuration/customer-search-rules-1\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://cloudify-c7720744.mintlify.site/_mintlify/api/og/v2?division=Configuration\u0026amp;title=Customer+Search+Rules\u0026amp;theme=e50b4891e5b09375f27db006\u0026amp;signature=3103f05b585015001fcbb4ff6ebe04667051e25638d28578048acf7108ebf4be\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Customer Search Rules - Cloudify Documentation\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://cloudify-c7720744.mintlify.site/_mintlify/api/og/v2?division=Configuration\u0026amp;title=Customer+Search+Rules\u0026amp;theme=e50b4891e5b09375f27db006\u0026amp;signature=3103f05b585015001fcbb4ff6ebe04667051e25638d28578048acf7108ebf4be\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/cloudify-c7720744/6Hmx_AJUh5PJc53T/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Cloudify Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#1a73e8\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.cloudify.biz/woocommerce/woocommerce-xero/configuration/customer-search-rules-1\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/woocommerce/woocommerce-xero/configuration/customer-search-rules-1.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.cloudify.biz/#organization\",\"name\":\"Cloudify Documentation\",\"url\":\"https://docs.cloudify.biz\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/cloudify-c7720744/Ie43f-kQkw_inATF/images/cloudify_kb_light.svg?fit=max\u0026auto=format\u0026n=Ie43f-kQkw_inATF\u0026q=85\u0026s=e6fee15c45d046196122c85fc772f27f\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.cloudify.biz#website\",\"name\":\"Cloudify Documentation\",\"url\":\"https://docs.cloudify.biz\",\"publisher\":{\"@id\":\"https://docs.cloudify.biz/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.cloudify.biz/woocommerce/woocommerce-xero/configuration/customer-search-rules-1#webpage\",\"url\":\"https://docs.cloudify.biz/woocommerce/woocommerce-xero/configuration/customer-search-rules-1\",\"name\":\"Customer Search Rules\",\"dateModified\":\"2026-10-01T09:00:33.122Z\",\"isPartOf\":{\"@id\":\"https://docs.cloudify.biz#website\"},\"breadcrumb\":{\"@id\":\"https://docs.cloudify.biz/woocommerce/woocommerce-xero/configuration/customer-search-rules-1#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.cloudify.biz/woocommerce/woocommerce-xero/configuration/customer-search-rules-1#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Configuration\",\"item\":\"https://docs.cloudify.biz/woocommerce/woocommerce-xero/configuration/getting-started\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Customer Search Rules\",\"item\":\"https://docs.cloudify.biz/woocommerce/woocommerce-xero/configuration/customer-search-rules-1\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.cloudify.biz/woocommerce/woocommerce-xero/configuration/customer-search-rules-1#article\",\"headline\":\"Customer Search Rules\",\"name\":\"Customer Search Rules\",\"url\":\"https://docs.cloudify.biz/woocommerce/woocommerce-xero/configuration/customer-search-rules-1\",\"mainEntityOfPage\":{\"@id\":\"https://docs.cloudify.biz/woocommerce/woocommerce-xero/configuration/customer-search-rules-1#webpage\"},\"dateModified\":\"2026-10-01T09:00:33.122Z\",\"publisher\":{\"@id\":\"https://docs.cloudify.biz/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.cloudify.biz#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Cloudify Documentation\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Cloudify Documentation\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/woocommerce/woocommerce-xero/configuration/customer-search-rules-1.md","siteName":"Cloudify Documentation","nav":{"global":{"anchors":[{"anchor":"Home","icon":"house","href":"/"}]},"products":[{"product":"Home","pages":[{"title":"Home","href":""}]},{"product":"HubSpot Xero Integration","description":"Integrate HubSpot with Xero to automate invoicing, sync customer data, reduce manual entry, and connect sales and accounting workflows seamlessly.","pages":[{"title":"HubSpot Xero Integration","href":"/hubspot/xero/getting-started/overview"}]},{"product":"HubSpot e-conomic Integration","description":"Integrate HubSpot with Visma e-conomic to automate invoicing, sync customer data, reduce manual work, and connect your sales and accounting workflows.","pages":[{"title":"HubSpot e-conomic Integration","href":"/hubspot/e-conomic/getting-started/overview"}]},{"product":"HubSpot Fortnox Integration","description":"Integrate HubSpot with Fortnox to sync customer and financial data, automate workflows, reduce manual entry, and streamline sales and accounting processes.","pages":[{"title":"HubSpot Fortnox Integration","href":"/hubspot/fortnox/getting-started/overview"}]},{"product":"HubSpot QuickBooks Integration","description":"By integrating HubSpot with QuickBooks Online, your organization can streamline sales and accounting workflows while reducing manual work.","pages":[{"title":"HubSpot QuickBooks Integration","href":"/hubspot/quickbooks/getting-started/overview"}]},{"product":"HubSpot Business Central Integration","description":"Integrate HubSpot with Microsoft Dynamics 365 Business Central to sync data, automate workflows, reduce manual entry, and streamline CRM and business operations.","pages":[{"title":"HubSpot Business Central Integration","href":"/hubspot/msbc/getting-started/overview"}]},{"product":"HubSpot FlowLink Integration","description":"Use FlowLink to enrich new HubSpot leads through a webhook workflow and route them based on the result.","pages":[{"title":"HubSpot FlowLink Integration","href":"/hubspot/flowlink/installation/installing-flowlink"}]},{"product":"HubSpot Tripletex Integration","description":"Integrate HubSpot with Tripletex to sync customer, product, and invoice data, reduce manual entry, and streamline CRM and accounting workflows.","pages":[{"title":"HubSpot Tripletex Integration","href":"/hubspot/tripletex/getting-started/overview"}]},{"product":"HubSpot Company VAT Integration","description":"Learn how the HubSpot Company VAT app validates VAT information using official lookup sources to keep company data accurate and up to date.","pages":[{"title":"HubSpot Company VAT Integration","href":"/hubspot/company-vat/getting-started/overview"}]},{"product":"HubSpot Danish CVR Integration","description":"Learn what the Danish CVR Lookup app does and how it helps enrich HubSpot company data with official Danish business information.","pages":[{"title":"HubSpot Danish CVR Integration","href":"/hubspot/danish-cvr/getting-started/overview"}]},{"product":"Shopify Xero Integration","description":"Integrate Shopify with Xero to sync orders, customers, products, and financial data, reduce manual entry, and streamline e-commerce accounting.","pages":[{"title":"Shopify Xero Integration","href":"/shopify/xero/getting-started/overview"}]},{"product":"Shopify e-conomic Integration","description":"Integrate Shopify with e-conomic to automate accounting workflows, streamline financial data, reduce manual entry, and simplify e-commerce operations.","pages":[{"title":"Shopify e-conomic Integration","href":"/shopify/e-conomic/getting-started/overview"}]},{"product":"Shopify Fortnox Integration","description":"Connect Shopify with Fortnox to sync e-commerce and accounting data, automate workflows, reduce manual entry, and streamline financial operations.","pages":[{"title":"Shopify Fortnox Integration","href":"/shopify/fortnox/getting-started/overview"}]},{"product":"Shopify Tripletex Integration","description":"Connect Shopify with Tripletex using Cloudify to sync e-commerce and accounting data, automate workflows, reduce manual entry, and streamline financial operations.","pages":[{"title":"Shopify Tripletex Integration","href":"/shopi/tripletex/getting-started/overview"}]},{"product":"Stripe e-conomic Integration","description":"Connect Stripe with e-conomic to sync webshop data, manage invoices and orders, reduce manual entry, and streamline your accounting workflow.","pages":[{"title":"Stripe e-conomic Integration","href":"/stripe/e-conomic/getting-started/overview"}]},{"product":"Stripe Business Central Integration","description":"Connect Stripe with Business Central to sync payment data, reduce manual work, improve financial accuracy, and streamline your accounting workflow.","pages":[{"title":"Stripe Business Central Integration","href":"/stripe/msbc/getting-started/overview"}]},{"product":"Pipedrive Xero Integration","description":"Step-by-step guide to installing the Cloudify Xero Integration from either the Xero App Store or the Pipedrive Marketplace, and connecting your Xero account.","pages":[{"title":"Pipedrive Xero Integration","href":"/pipedrive/xero/getting-started/overview"}]},{"product":"Pipedrive e-conomic Integration","description":"Step-by-step guide to installing the Visma e-conomic sync app in Pipedrive and connecting your e-conomic account.","pages":[{"title":"Pipedrive e-conomic Integration","href":"/pipedrive/e-conomic/getting-started/overview"}]},{"product":"Pipedrive Fortnox Integration","description":"Integrate Pipedrive with Fortnox to sync CRM and accounting data, reduce manual entry, automate workflows, and streamline sales and financial operations.","pages":[{"title":"Pipedrive Fortnox Integration","href":"/pipedrive/fortnox/getting-started/overview"}]},{"product":"Pipedrive Business Central Integration","description":"Connect Pipedrive with Microsoft Dynamics 365 Business Central to sync CRM and business data, automate workflows, reduce manual entry, and streamline operations.","pages":[{"title":"Pipedrive Business Central Integration","href":"/pipedrive/msbc/getting-started/overview"}]},{"product":"Pipedrive Company VAT Integration","description":"Use Pipedrive Company VAT to verify VAT details, improve company data accuracy, and keep business information up to date directly in your CRM.","pages":[{"title":"Pipedrive Company VAT Integration","href":"/pipedrive/company-vat/getting-started/overview"}]},{"product":"Pipedrive Danish CVR Integration","description":"Integrate Danish CVR data with Pipedrive to improve company information, reduce manual research, and keep customer records accurate and up to date.","pages":[{"title":"Pipedrive Danish CVR Integration","href":"/pipedrive/danish-cvr/getting-started/overview"}]},{"product":"WooCommerce Xero","description":"Integrate WooCommerce with Xero to automate invoices and quotes, sync orders, customers, and products, and reduce manual accounting data entry.","groups":[{"group":"Getting-Started","pages":[{"title":"Overview","href":"/woocommerce-xero/getting-started/overview"},{"title":"Prerequisites","href":"/woocommerce/woocommerce-xero/getting-started/prerequisites"},{"title":"Choose Your Subscription plans","href":"/woocommerce/woocommerce-xero/installation/check-subscription-plans"}]},{"group":"Installation","pages":[{"title":"Installing the plugin","href":"/woocommerce/woocommerce-xero/installation/install-the-plugin"},{"title":"Invoice / Quote Creation Rules","href":"/woocommerce/woocommerce-xero/installation/invoice-quote-rules"},{"title":"Customer Search Rules","href":"/woocommerce/woocommerce-xero/installation/customer-search-rules"},{"title":"Product Sync Rules","href":"/woocommerce/woocommerce-xero/installation/product-search-rules"}]},{"group":"Configuration","pages":[{"title":"Getting Started","description":"How to access the integration settings in your WordPress admin panel.","href":"/woocommerce/woocommerce-xero/configuration/getting-started"},{"title":"Customer Search Rules","href":"/woocommerce/woocommerce-xero/configuration/customer-search-rules-1"},{"title":"Product Search Rules","description":null,"href":"/woocommerce/woocommerce-xero/configuration/product-search-rules-1"},{"title":"Invoice/Quote Search Rules","href":"/woocommerce/woocommerce-xero/configuration/invoice-quote-rules-1"}]}]},{"product":"Lighthouse","pages":[{"title":"Lighthouse","href":"/lighthouse-overview"}]},{"product":"Fortnox configuration","pages":[{"title":"Fortnox configuration","href":"/configurations/fortnox/fortnox-configuration"}]},{"product":"Shopify Pennylane","description":"Set up the Shopify-Pennylane integration by Cloudify: connect your account, configure sync rules, and turn Shopify orders into Pennylane invoices automatically","pages":[{"title":"Shopify Pennylane","href":"/shopi/pennylane/getting-started/overview"}]},{"product":"HubSpot e-conomic"},{"product":"WooCommerce-Xero"},{"product":"Shopify Exact Online","pages":[{"title":"Shopify Exact Online","href":"/shopi-exactonline-overview"}]},{"product":"Setting up the Lighthouse HubSpot Connection","pages":[{"title":"Setting up the Lighthouse HubSpot Connection","href":"/setting-up-the-lighthouse-hubspot-connection"}]}]},"basePath":"","title":"Customer Search Rules - Cloudify Documentation","buildId":"dpl_9RFrWkXdFTJCytfx6jAofvAaEXr6","deploymentId":"dpl_9RFrWkXdFTJCytfx6jAofvAaEXr6","dynamics":["07c022d89b","a74be98ba7"],"chunks":["Frame-1H5zLJUq.js","DynamicMarkdown-RhjEuCHC.js","zoom-image-lightbox-CkI5al_8.js","lightbox-handle-r17bVUz3.js"]}