diff --git a/guides/activities.mdx b/guides/activities.mdx
index e9154c6..56190c0 100644
--- a/guides/activities.mdx
+++ b/guides/activities.mdx
@@ -72,7 +72,7 @@ console.log(`Activity ID: ${activity.id}`);
 |-------|------|----------|-------------|
 | `type` | string | Yes | Activity type (see [supported types](/guides/nutrition-calculation#supported-activity-types)) |
 | `duration_min` | integer | Yes | Expected duration in minutes |
-| `intensity_level` | integer | No | 1-9 scale |
+| `intensity_level` | integer | No | 1-9 scale; `lift` and `hike` use 1-3 (low, medium, high), store anything higher as 3, and an omitted level counts as 2 |
 | `thermal_stress_level` | integer | No | 1-9 scale |
 | `is_race_event` | boolean | No | Whether this is a race |
 | `meal_before_min` | integer | No | Minutes between the athlete's last meal and the start |
diff --git a/guides/batch-operations.mdx b/guides/batch-operations.mdx
index 052c97a..68bcebf 100644
--- a/guides/batch-operations.mdx
+++ b/guides/batch-operations.mdx
@@ -267,7 +267,7 @@ An imported activity accepts these fields and no others. Unknown keys are ignore
 |-------|----------|-------------|
 | `type` | Yes | One of `bike`, `run`, `swim`, `row`, `ski`, `lift`, `hike` |
 | `duration_min` | Yes | Positive integer |
-| `intensity_level` | No | 1 to 9; the calculation clamps values outside the scale |
+| `intensity_level` | No | 1 to 9; the calculation clamps values outside the scale. `lift` and `hike` use 1 to 3, store anything higher as 3, and an omitted level counts as 2 |
 | `thermal_stress_level` | No | 1 to 9; the calculation clamps values outside the scale |
 | `is_race_event` | No | Boolean |
 | `external_id` | No | Your activity ID, carried through and used by finish-screen deep links |