A rebuilt Earning Overview setup and clearer bulk update results

The Earning Overview widget takes its ways to earn from Currency Overview and gains a banner, and the bulk update API gives a reason for each failed row.

01 ·Earning Overview settings that follow Currency Overview

The Earning Overview widget has a rebuilt Settings tab. A new Use earning overview settings checkbox shows whether the widget still mirrors the Currency Overview settings page. New widgets start with it ticked. Widgets made before this build start with it clear and keep their own configuration. Any edit in the panel clears the box, and ticking it again returns the widget to mirroring.

Ways to Earn now lists what is set up on Currency Overview: milestones, badges, social quests and channel actions. Milestones appear by name, or as one Milestones row when none are chosen, and each custom section gets its own row. Admins now create custom ways to earn on Currency Overview. In the Settings tab, each section:

• has Header and Description checkboxes, and hiding either leaves no gap in the widget
• has a description the admin can edit for this widget
• collapses behind a chevron
• hides on the live widget when its feature is switched off in Currency Overview

02 ·Display controls and a banner for the Earning Overview widget

Your Earnings groups its rows by currency (XP, Coins, then each custom currency by name). Coins Balance can be switched off, and switching it off clears Total Earned and Expiring as well. Earning Activities swaps its drag-and-drop field list for seven checkboxes in a fixed order (Action, Action Details, Date, Time, Location, Coins Activity, XP Activity), and each one shows or hides its column.

Ways to Earn has a Show CTA Button checkbox, on by default, and clearing it hides every CTA button in the section. The widget also takes a banner. Upload it at the bottom of the Settings tab, with separate light and dark theme images and the same 1800 x 300 px guidance as the Milestones widget, and it appears above the sections in the preview and the live widget.

03 ·A failure reason for every row in the bulk update API

The API call that returns the details of a finished bulk update job gives each row a status (success or failed) and a list of errors. A successful row has an empty list. A failed row carries at least one error, each with a stable code, a fixed message and, when one is recorded, the field involved. The codes cover cases such as:

• a user not found in the target community, or not a member of it
• a missing required value, or a duplicate value in the upload
• an identifier that conflicts with an existing user
• an invalid operation or field value
• an outcome that could not be confirmed

Anything else returns a generic Bulk row failed error, and a row lists at most 10 errors. Row statuses and the job's success and failure counts come from the same errors, so the two agree. The endpoint, its authentication, permissions and pagination stay the same.