Accentuate Custom Fields
  • Welcome!
  • Introduction
    • Getting started with ACF
    • Field scopes
    • How to show fields in your storefront
  • Dashboard
    • Reference Manager
      • Creating a new reference within Reference Manager
    • Filter & Group
      • Filter editor
      • Filter usage
    • Activity log
    • App settings
  • Field Definitions
    • Fields & Sections
    • Deciding on a field type
    • ACF Field types
      • Text
      • Markdown text
      • HTML
      • Checkbox
      • Selection
      • Tags
      • Number
      • Date
      • Color
      • Media v1 (legacy)
      • Media v2
      • Custom Object (JSON)
      • Multi-language Text
      • Reference fields
      • References to Global fields
    • Shopify Field types
      • Shopify » Single line text
      • Shopify » Multi-line text
      • Shopify » Boolean
      • Shopify » Color
      • Shopify » Custom objects (JSON)
      • Shopify » URL
      • Shopify » Date
      • Shopify » Date and Time
      • Shopify » Integer
      • Shopify » Decimal
      • Shopify » Weight
      • Shopify » Volume
      • Shopify » Dimensions
      • Shopify » Reference fields
    • Automatic tagging
    • Large sets
    • Field contexts
    • Field context filters
    • Copy and paste fields
    • Change field name and type
    • Import existing fields
    • Linking multiple stores
  • The Editor
    • Using the editor
    • Promote fields to sidebar
    • Layouts
    • Hide from search
    • Repeatable fields
    • Version control
    • Update value on order creation
  • Bulk Import & Export
    • Export custom field values
    • Import custom field values
    • Metaobject export / import
  • METAOBJECTS
    • What are Metaobjects?
    • Metaobject Definitions
    • Metaobject instances / values
    • Displaying Metaobjects on your storefront
    • Metaobject export / import
  • THEME EXTENSIONS
    • SEO keywords
    • Sticky promo bar
    • Products promotion
  • Liquid Guides
    • Learning Liquid
    • Resize & crop images
    • Check for empty values
    • Access field definitions
    • Order notifications
    • Allow customers to change their field values
  • OTHER
    • Webhooks
    • API
      • Access to custom fields
      • Endpoints
  • Help
    • FAQ
      • Why are one of my products no longer showing in my reference field?
      • I have multiple products/variants with the same name
      • How do I make changes to my field values in bulk?
      • I added a new field definition but it is not showing in my storefront
      • How do I copy my field setup to another store?
      • My fields are still showing after I have deleted their field definition
      • Why are none of my fields showing in the editor?
      • My newly created object in Shopify is not available in ACF
      • Reference lists are empty?
      • Why am I seeing a "value cannot exceed 100,000 characters" error when saving?
      • Why can't I name my field "first", "last" or "size"?
    • Need help?
  • Product
    • Changelog
    • Feedback & Suggestions
Powered by GitBook
On this page
  • Consideration for repeatable field values
  • Considerations for HTML fields
  • Considerations for multi-language fields
  • Considerations for bulk uploading media files
  1. Bulk Import & Export

Import custom field values

Importing custom field values relies on the exact same XLSX format as provided by the export, so you may use an exported file directly as the source for import. Except for the required A and B columns, you may remove any columns from C and forward as you see fit, but, if present, the header value must match a defined field name for the type. The same applies to rows - only objects directly referenced by an _id value are considered for updates, making it possible to do fast, partial updates. Shop or Global level imports don't use the _id field but will always update the provided columns with custom fields for the shop being imported into.

Imports run in the background. You can safely leave the page while the import runs, but you are encouraged not to make any changes to the custom fields while the import runs. If you start additional import jobs, the data will be added to the import queue and imported in the order of upload

Consideration for repeatable field values

To provide multiple values for a custom field defined as a repeatable field, you need to format this carefully. ACF exports and imports values for repeatable fields in an "array" notation starting with an opening square bracket ( [ ) followed by a quoted and comma-separated list of values and then a closing square bracket ( ] ). Examples:

["1", "2", "3"]
["John", "Stacey"]
["Awesome"]
Awesome

for three values 1, 2 and 3, two values "John" and "Stacey" and a single value "Awesome" respectively (note that a single value can also be stated without square brackets).

Considerations for HTML fields

You can import HTML content to HTML fields just like any other piece of data, but there is also an option to import Markdown content directly to an HTML field. This comes in handy if you want to data from Markdown fields (or Markdown from a different source) to a new HTML field. All you need to do is to prefix the Markdown content with the tag <markdown> as shown here:

<markdown>
###Title
- list item 1
- list item 2

The ACF importer will grab the Markdown content after the initial tag and render it as HTML before importing it. Note that the same applies to repeatable HTML values as outlined above.

Considerations for multi-language fields

Multi-language fields are structured in JSON objects with the individual language locales as keys. It is important to adhere to the provided format when importing content for the languages. Examples:

{
  "en": "Goodnight", 
  "de": "Guten Abend"
}

Each of the keys ( "en" and "de" in the above example) must match the selected ISO locales set up for your multi-language content for the text to show up in ACF. Note, that if your multi-language field is also a repeatable field, the above format will be in an array like this:

[{
  "en": "Goodnight", 
  "de": "Guten Abend"
},
{
  "en": "Good morning", 
  "de": "Guten Morgen"
}]

When manually editing content for each language in an import file, please ensure that any double quotes are "escaped", i.e. prefixed by a backslash:

{ 
 "en": "My name is \"Boss\"",
 "de": "Mein Name ist \"Boss\"" 
}

Considerations for bulk uploading media files

An import file can also bulk upload media to both Media v1 and v2 type fields. If you provide publicly available URLs as the value (full HTTP/HTTPS URL), the referenced media will be copied to ACF's secure data storage bucket, and the new URL to the uploaded media will be stored in the corresponding Metafield. If you want to delete a media, clear the field's value in the import file. When uploading media in bulk to a repeatable Media v1 field, you will need to provide the URLs as a JSON array with each occurrence listed inside the array: To load 4 occurrences of a media:

["url", "url", "url", "url"]

When uploading media in bulk to a repeatable Media v2 field, you will need to provide the URLs as a JSON array of arrays, so to load 4 occurrences of two media each:

 [["url", "url"], ["url", "url"], ["url", "url"], ["url", "url"]]
PreviousExport custom field valuesNextMetaobject export / import

Last updated 10 months ago