Customise event field mappings

Change how Littledata maps Shopify event data to the parameters your analytics destination expects.

Field mappings control how Littledata maps Shopify data to destination parameters.

You can override defaults, add custom parameters, and preview the result before saving.

Open the editor

1

Open the destination Events tab

Start in the Events tab for the destination you want to customise.

2

Select an event

Click any event row to open its editor.

3

Review the editor sections

The editor has three parts:

• Event Trigger — the Shopify event that powers the customisation.

• Field Mappings — the source-to-destination field relationships.

• Event Preview — a preview of the destination payload.

Mapping types

Locked mappings

These mappings are required by the destination platform.

Both the source and destination are read-only.

Editable standard mappings

These mappings use Littledata defaults.

You can change the source field, but not the destination field.

For example, GA4 maps products[*].productId to items[*].item_id by default.

You can switch the source to products[*].sku instead.

Custom parameters

Custom parameters let you add fields outside the default schema.

Each one has a source dropdown and a destination name field.

The source dropdown includes standard Shopify fields and configured Custom Data Sources.

Each event has a custom parameter limit. The Add parameter button disables at the limit.

Add a custom parameter

1

Go to Field Mappings

Scroll to the bottom of the Field Mappings section.

2

Add a new row

Click Add parameter.

3

Choose the source

Select the Shopify field you want to send.

4

Name the destination parameter

Enter the destination parameter name, such as material.

To remove a custom parameter, click the X beside that row.

Standard and locked mappings cannot be removed.

Save or delete a customisation

1

Review the preview

Use Event preview to confirm your output.

2

Save or discard

Click Save to apply the customisation.

Click Discard to undo unsaved changes.

3

Delete if needed

To remove the customisation entirely, open the overflow menu and click Delete.

Changes only affect future events. Historical events stay unchanged.