{"id":9280,"date":"2026-09-03T10:22:16","date_gmt":"2026-09-03T10:22:16","guid":{"rendered":"https:\/\/techmarbles.com\/products\/?post_type=docs&#038;p=9280"},"modified":"2026-09-03T10:22:17","modified_gmt":"2026-09-03T10:22:17","slug":"customer-settings-9280","status":"publish","type":"docs","link":"https:\/\/techmarbles.com\/products\/docs\/odoo-integration\/customer-settings-9280\/","title":{"rendered":"Field Mapping"},"content":{"rendered":"\n<p class=\"wp-block-paragraph\"><em>(New module.)<\/em>&nbsp;Field Mapping lets you define custom rules that map fields between Odoo and Shopify for&nbsp;<strong>Orders, Products, and Customers<\/strong>, in either direction, with optional conditions.<\/p>\n\n\n\n<blockquote class=\"wp-block-quote is-layout-flow wp-block-quote-is-layout-flow\">\n<p class=\"wp-block-paragraph\"><strong>When to use it:<\/strong>&nbsp;The most common standard fields are already mapped during normal sync. Use Field Mapping only when you need&nbsp;<strong>extra field pairs<\/strong>,&nbsp;<strong>custom Odoo fields<\/strong>,&nbsp;<strong>metafields<\/strong>,&nbsp;<strong>media\/images<\/strong>, or&nbsp;<strong>conditional<\/strong>&nbsp;mapping.<\/p>\n<\/blockquote>\n\n\n\n<p class=\"wp-block-paragraph\">Open it from the&nbsp;<strong>Field Mapping<\/strong>&nbsp;link, then pick a tab:&nbsp;<strong>Orders<\/strong>,&nbsp;<strong>Products<\/strong>, or&nbsp;<strong>Customers<\/strong>.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Creating a Mapping Rule<\/h3>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Click\u00a0<strong>Add mapping<\/strong>\u00a0(a new row opens in edit mode).<\/li>\n\n\n\n<li><strong>Sync direction<\/strong>\u00a0\u2014\u00a0<strong>Shopify \u2192 Odoo<\/strong>\u00a0or\u00a0<strong>Odoo \u2192 Shopify<\/strong>.<\/li>\n\n\n\n<li><strong>Shopify side:<\/strong>\n<ul class=\"wp-block-list\">\n<li><em>(Products only)<\/em>\u00a0<strong>Shopify level<\/strong>\u00a0\u2014\u00a0<strong>Product<\/strong>\u00a0or\u00a0<strong>Product variant<\/strong>.<\/li>\n\n\n\n<li><strong>Shopify field type<\/strong>\u00a0\u2014\u00a0<strong>Standard fields<\/strong>,\u00a0<strong>Metafields<\/strong>, or\u00a0<strong>Product media<\/strong>\u00a0(media is Odoo \u2192 Shopify only).<\/li>\n\n\n\n<li><strong>Shopify field<\/strong>\u00a0\u2014 pick the field\/metafield\/media target. On the\u00a0<strong>Orders<\/strong>\u00a0tab, standard fields include\u00a0<strong>Note<\/strong>\u00a0and\u00a0<strong>Note attributes<\/strong>\u00a0<em>(new)<\/em>\u00a0\u2014 Shopify checkout note attributes are formatted to match the target Odoo field type.<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li><strong>Odoo side:<\/strong>\n<ul class=\"wp-block-list\">\n<li><em>(Products)<\/em>\u00a0<strong>Odoo model<\/strong>\u00a0\u2014 Variant (<code>product.product<\/code>), Template (<code>product.template<\/code>), Vendor (<code>product.supplierinfo<\/code>), or\u00a0<strong>Product attributes<\/strong>\u00a0<em>(new)<\/em>.<\/li>\n\n\n\n<li><em>(Customers)<\/em>\u00a0<strong>Odoo model<\/strong>\u00a0\u2014 Main contact, Billing address, or Shipping\/delivery address.<\/li>\n\n\n\n<li><strong>Odoo field type<\/strong>\u00a0\u2014\u00a0<strong>Default fields<\/strong>,\u00a0<strong>Custom fields (<\/strong><strong><code>x_*<\/code><\/strong><strong>)<\/strong>\u00a0(loaded live from Odoo), or\u00a0<strong>Attribute Names<\/strong>\u00a0<em>(new, with the Product attributes model)<\/em>.<\/li>\n\n\n\n<li><strong>Odoo field<\/strong>\u00a0\u2014 pick the field (or the attribute name).<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li><em>(Optional)<\/em><strong>Optional condition<\/strong>\u00a0\u2014 apply the mapping only when a condition is met:\n<ul class=\"wp-block-list\">\n<li><strong>Field path<\/strong>\u00a0(dot notation, e.g.\u00a0<code>tags<\/code>\u00a0or\u00a0<code>addresses.0.country<\/code>)<\/li>\n\n\n\n<li><strong>Operator<\/strong>\u00a0\u2014 equals \/ not equals \/ in list \/ contains \/ empty \/ not empty<\/li>\n\n\n\n<li><strong>Value<\/strong>\u00a0(or comma-separated values for &#8220;in list&#8221;)<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li>Keep\u00a0<strong>Enabled<\/strong>\u00a0checked (or uncheck to keep the rule but pause it), then click\u00a0<strong>Done<\/strong>.<\/li>\n\n\n\n<li>Repeat as needed, then\u00a0<strong>Save<\/strong>\u00a0(a rule must have both fields selected before you can add another).<\/li>\n<\/ol>\n\n\n\n<h3 class=\"wp-block-heading\">Capabilities<\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Custom Odoo fields<\/strong>\u00a0(<code>x_*<\/code>) \u2014 including auto-discovery from Odoo.<\/li>\n\n\n\n<li><strong>Metafields<\/strong>\u00a0\u2014 map to\/from Shopify metafields (text, boolean, JSON, measurement units, rich text, list, references, links, etc.).<\/li>\n\n\n\n<li><strong>Product attributes \u2192 metafields<\/strong>\u00a0<em>(new)<\/em>\u00a0\u2014 write the value(s) of a selected Odoo product attribute to a Shopify metafield (Odoo \u2192 Shopify).<\/li>\n\n\n\n<li><strong>Order note attributes<\/strong>\u00a0<em>(new)<\/em>\u00a0\u2014 map Shopify checkout note attributes to an Odoo order field, formatted for the target field type (Shopify \u2192 Odoo).<\/li>\n\n\n\n<li><strong>Unit prices<\/strong>\u00a0<em>(new)<\/em>\u00a0\u2014 populate Shopify&#8217;s native unit price: map the Odoo quantity field (e.g.\u00a0<em>Base Unit Count<\/em>) as the Odoo field, then choose the\u00a0<strong>Odoo unit field<\/strong>\u00a0(e.g.\u00a0<em>Base Unit of Measure<\/em>). A reference amount in the unit name is respected \u2014 &#8220;100 g&#8221; shows the price per 100 g, &#8220;kg&#8221; per 1 kg.<\/li>\n\n\n\n<li><strong>Product media \/ image URLs<\/strong>\u00a0<em>(new)<\/em>\u00a0\u2014 map an Odoo URL field to Shopify\u00a0<strong>product<\/strong>\u00a0or\u00a0<strong>variant<\/strong>\u00a0media (Odoo \u2192 Shopify).<\/li>\n\n\n\n<li><strong>Many2one fields<\/strong>\u00a0\u2014 resolved to display names automatically.<\/li>\n\n\n\n<li><strong>Addresses &amp; company<\/strong>\u00a0\u2014 map Shopify address blocks to Odoo main\/billing\/delivery partners (company can be merged into the street line).<\/li>\n\n\n\n<li><strong>Measurement units<\/strong>\u00a0\u2014 automatic conversion (weight \u2192 kg, dimensions \u2192 cm, volume \u2192 liters by default).<\/li>\n\n\n\n<li><strong>Conditional rules<\/strong>\u00a0\u2014 e.g., only map a field when Shopify tags contain a value.<\/li>\n\n\n\n<li><strong>Multi-company<\/strong>\u00a0\u2014 rules can be scoped to a specific Odoo company.<\/li>\n\n\n\n<li><strong>Contextual validation<\/strong>\u00a0\u2014 incomplete rules are flagged inline on the exact row and field that needs attention.<\/li>\n<\/ul>\n","protected":false},"excerpt":{"rendered":"<p>(New module.)&nbsp;Field Mapping lets you define custom rules that map fields between Odoo and Shopify for&nbsp;Orders, Products, and Customers, in either direction, with optional conditions. When to use it:&nbsp;The most common standard fields are already mapped during normal sync. Use Field Mapping only when you need&nbsp;extra field pairs,&nbsp;custom Odoo fields,&nbsp;metafields,&nbsp;media\/images, or&nbsp;conditional&nbsp;mapping. Open it from the&nbsp;Field &#8230; <a title=\"Field Mapping\" class=\"read-more\" href=\"https:\/\/techmarbles.com\/products\/docs\/odoo-integration\/customer-settings-9280\/\" aria-label=\"Read more about Field Mapping\">Read more<\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"parent":8193,"menu_order":8,"comment_status":"open","ping_status":"closed","template":"","doc_tag":[],"doc_badge":[],"class_list":["post-9280","docs","type-docs","status-publish","hentry"],"acf":[],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v27.6 - https:\/\/yoast.com\/product\/yoast-seo-wordpress\/ -->\n<title>Field Mapping - TechMarbles Products<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/techmarbles.com\/products\/docs\/odoo-integration\/customer-settings-9280\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Field Mapping - TechMarbles Products\" \/>\n<meta property=\"og:description\" content=\"(New module.)&nbsp;Field Mapping lets you define custom rules that map fields between Odoo and Shopify for&nbsp;Orders, Products, and Customers, in either direction, with optional conditions. When to use it:&nbsp;The most common standard fields are already mapped during normal sync. Use Field Mapping only when you need&nbsp;extra field pairs,&nbsp;custom Odoo fields,&nbsp;metafields,&nbsp;media\/images, or&nbsp;conditional&nbsp;mapping. Open it from the&nbsp;Field ... Read more\" \/>\n<meta property=\"og:url\" content=\"https:\/\/techmarbles.com\/products\/docs\/odoo-integration\/customer-settings-9280\/\" \/>\n<meta property=\"og:site_name\" content=\"TechMarbles Products\" \/>\n<meta property=\"article:publisher\" content=\"https:\/\/www.facebook.com\/techmarbles\" \/>\n<meta property=\"article:modified_time\" content=\"2026-09-03T10:22:17+00:00\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"3 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/techmarbles.com\\\/products\\\/docs\\\/odoo-integration\\\/customer-settings-9280\\\/\",\"url\":\"https:\\\/\\\/techmarbles.com\\\/products\\\/docs\\\/odoo-integration\\\/customer-settings-9280\\\/\",\"name\":\"Field Mapping - TechMarbles Products\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/techmarbles.com\\\/products\\\/#website\"},\"datePublished\":\"2026-09-03T10:22:16+00:00\",\"dateModified\":\"2026-09-03T10:22:17+00:00\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/techmarbles.com\\\/products\\\/docs\\\/odoo-integration\\\/customer-settings-9280\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/techmarbles.com\\\/products\\\/docs\\\/odoo-integration\\\/customer-settings-9280\\\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/techmarbles.com\\\/products\\\/docs\\\/odoo-integration\\\/customer-settings-9280\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/techmarbles.com\\\/products\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Odoo Integration\",\"item\":\"https:\\\/\\\/techmarbles.com\\\/products\\\/docs\\\/odoo-integration\\\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Field Mapping\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/techmarbles.com\\\/products\\\/#website\",\"url\":\"https:\\\/\\\/techmarbles.com\\\/products\\\/\",\"name\":\"TechMarbles\",\"description\":\"\",\"publisher\":{\"@id\":\"https:\\\/\\\/techmarbles.com\\\/products\\\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/techmarbles.com\\\/products\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"},{\"@type\":\"Organization\",\"@id\":\"https:\\\/\\\/techmarbles.com\\\/products\\\/#organization\",\"name\":\"TechMarbles\",\"url\":\"https:\\\/\\\/techmarbles.com\\\/products\\\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/techmarbles.com\\\/products\\\/#\\\/schema\\\/logo\\\/image\\\/\",\"url\":\"https:\\\/\\\/techmarbles.com\\\/products\\\/wp-content\\\/uploads\\\/2025\\\/12\\\/techmarble-1.png\",\"contentUrl\":\"https:\\\/\\\/techmarbles.com\\\/products\\\/wp-content\\\/uploads\\\/2025\\\/12\\\/techmarble-1.png\",\"width\":1472,\"height\":304,\"caption\":\"TechMarbles\"},\"image\":{\"@id\":\"https:\\\/\\\/techmarbles.com\\\/products\\\/#\\\/schema\\\/logo\\\/image\\\/\"},\"sameAs\":[\"https:\\\/\\\/www.facebook.com\\\/techmarbles\",\"https:\\\/\\\/www.instagram.com\\\/techmarbles\\\/\"]}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Field Mapping - TechMarbles Products","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/techmarbles.com\/products\/docs\/odoo-integration\/customer-settings-9280\/","og_locale":"en_US","og_type":"article","og_title":"Field Mapping - TechMarbles Products","og_description":"(New module.)&nbsp;Field Mapping lets you define custom rules that map fields between Odoo and Shopify for&nbsp;Orders, Products, and Customers, in either direction, with optional conditions. When to use it:&nbsp;The most common standard fields are already mapped during normal sync. Use Field Mapping only when you need&nbsp;extra field pairs,&nbsp;custom Odoo fields,&nbsp;metafields,&nbsp;media\/images, or&nbsp;conditional&nbsp;mapping. Open it from the&nbsp;Field ... Read more","og_url":"https:\/\/techmarbles.com\/products\/docs\/odoo-integration\/customer-settings-9280\/","og_site_name":"TechMarbles Products","article_publisher":"https:\/\/www.facebook.com\/techmarbles","article_modified_time":"2026-09-03T10:22:17+00:00","twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"3 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/techmarbles.com\/products\/docs\/odoo-integration\/customer-settings-9280\/","url":"https:\/\/techmarbles.com\/products\/docs\/odoo-integration\/customer-settings-9280\/","name":"Field Mapping - TechMarbles Products","isPartOf":{"@id":"https:\/\/techmarbles.com\/products\/#website"},"datePublished":"2026-09-03T10:22:16+00:00","dateModified":"2026-09-03T10:22:17+00:00","breadcrumb":{"@id":"https:\/\/techmarbles.com\/products\/docs\/odoo-integration\/customer-settings-9280\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/techmarbles.com\/products\/docs\/odoo-integration\/customer-settings-9280\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/techmarbles.com\/products\/docs\/odoo-integration\/customer-settings-9280\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/techmarbles.com\/products\/"},{"@type":"ListItem","position":2,"name":"Odoo Integration","item":"https:\/\/techmarbles.com\/products\/docs\/odoo-integration\/"},{"@type":"ListItem","position":3,"name":"Field Mapping"}]},{"@type":"WebSite","@id":"https:\/\/techmarbles.com\/products\/#website","url":"https:\/\/techmarbles.com\/products\/","name":"TechMarbles","description":"","publisher":{"@id":"https:\/\/techmarbles.com\/products\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/techmarbles.com\/products\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Organization","@id":"https:\/\/techmarbles.com\/products\/#organization","name":"TechMarbles","url":"https:\/\/techmarbles.com\/products\/","logo":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/techmarbles.com\/products\/#\/schema\/logo\/image\/","url":"https:\/\/techmarbles.com\/products\/wp-content\/uploads\/2025\/12\/techmarble-1.png","contentUrl":"https:\/\/techmarbles.com\/products\/wp-content\/uploads\/2025\/12\/techmarble-1.png","width":1472,"height":304,"caption":"TechMarbles"},"image":{"@id":"https:\/\/techmarbles.com\/products\/#\/schema\/logo\/image\/"},"sameAs":["https:\/\/www.facebook.com\/techmarbles","https:\/\/www.instagram.com\/techmarbles\/"]}]}},"author_avatar":"https:\/\/secure.gravatar.com\/avatar\/61606c88d97c6f095279736996ce1baad72b9885f038d7f81c92f169cc5817cd?s=96&d=mm&r=g","author_name":"manish","_links":{"self":[{"href":"https:\/\/techmarbles.com\/products\/wp-json\/wp\/v2\/docs\/9280","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/techmarbles.com\/products\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/techmarbles.com\/products\/wp-json\/wp\/v2\/types\/docs"}],"author":[{"embeddable":true,"href":"https:\/\/techmarbles.com\/products\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/techmarbles.com\/products\/wp-json\/wp\/v2\/comments?post=9280"}],"version-history":[{"count":2,"href":"https:\/\/techmarbles.com\/products\/wp-json\/wp\/v2\/docs\/9280\/revisions"}],"predecessor-version":[{"id":9282,"href":"https:\/\/techmarbles.com\/products\/wp-json\/wp\/v2\/docs\/9280\/revisions\/9282"}],"up":[{"embeddable":true,"href":"https:\/\/techmarbles.com\/products\/wp-json\/wp\/v2\/docs\/8193"}],"wp:attachment":[{"href":"https:\/\/techmarbles.com\/products\/wp-json\/wp\/v2\/media?parent=9280"}],"wp:term":[{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/techmarbles.com\/products\/wp-json\/wp\/v2\/doc_tag?post=9280"},{"taxonomy":"doc_badge","embeddable":true,"href":"https:\/\/techmarbles.com\/products\/wp-json\/wp\/v2\/doc_badge?post=9280"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}