NewMaxio Metering is now available — usage-based billing for Advanced Billing.Learn more
/

Configure Custom Field Mapping for Salesforce

··

Last updated on Aug 24, 2026

Map a custom field between Advanced Billing and Salesforce so its value syncs along with the rest of a record's data. Mapping a custom field takes two parts: creating the field in Salesforce, then pointing the integration at it.

Create the Salesforce field

Before you can map a custom field, the Salesforce field it maps to must already exist and be added to the right page layout.

To create the field

  1. Navigate to Setup > Object Manager.

    Salesforce Setup with Object Manager outlined in the Quick Find results under Objects and Fields

  2. Choose the object the field belongs on, for example Maxio AB Subscription.

  3. Click Fields & Relationships, then click New.

    the Fields and Relationships list on the Maxio AB Subscription object, with New outlined

  4. Choose the field type that best fits the data this field will hold, then click Next.

    the Salesforce field type chooser, listing the available data types for the new field

  5. Enter the required details, then click Next:

    • Field Label - Used in page layouts, reports, and list views.

    • Field Length - The maximum length for a Text field.

    • Field Name - An internal reference used for custom links, custom s-controls, and the API.

      Changing the Field Name after it's in use may affect existing integrations.

      step two of the new field wizard, with Field Label, Length, Field Name and Help Text to fill in

  6. Select the field-level security for each profile listed, then click Next. This field is hidden from any profile you don't select.

    step three of the wizard, setting field-level security as Visible or Read-Only for each profile

  7. Select which page layouts to add this field to, then click Save.

    step four of the wizard, choosing which page layouts the new field is added to

Confirm the field was added to the page layout you selected. Once it's there, it becomes available in Choose Salesforce Field when you map it in the next section.

the Fields and Relationships list with the newly created custom field outlined
Repeat this section for every custom field you want to map, and for every object it needs to appear on.

Map the custom field

Once the Salesforce field exists, connect it to its matching Advanced Billing field.

To map a custom field

  1. Navigate to the Maxio AB Configuration tab, find your site under Site Configuration, and click Configure.

    the Site Configuration table on the Maxio AB Configuration tab, with a site's Configure button outlined

  2. Scroll down to the Custom Fields Mapping section and click Add New Custom Field Mapping.

    an empty Custom Fields Mapping section with Add New Custom Field Mapping outlined

  3. In the Mapping custom fields popup, fill in these fields and click Save:

    • Choose Object - The Salesforce object the field belongs to, for example Subscription.
    • Choose Salesforce Field - The field you created in the previous section.
    • Choose Maxio AB Field - The Advanced Billing field to map it to.

    the Mapping custom fields popup pairing the Salesforce CurrencyIsoCode field with the Advanced Billing Currency-Text field

To install and connect the integration before mapping custom fields, see Setup the Salesforce Integration.

Still need help?
Reach out and our support team will take it from here.

Contact support