diff --git a/ReferenceTests/src/tests/primitives.jl b/ReferenceTests/src/tests/primitives.jl
index dbc411ac2d0..f965feface9 100644
--- a/ReferenceTests/src/tests/primitives.jl
+++ b/ReferenceTests/src/tests/primitives.jl
@@ -457,3 +457,18 @@ end
 
     fig
 end
+
+@reference_test "datashader" begin
+    airports = Point2f.(eachrow(readdlm(Makie.assetpath("airportlocations.csv"))))
+    fig, ax, ds = datashader(airports, async = false)
+    Colorbar(fig[1, 2], ds, width=100)
+    hidedecorations!(ax); hidespines!(ax)
+
+    normaldist = randn(Point2f, 1_000_000)
+    ds1 = normaldist .+ (Point2f(-1, 0),)
+    ds2 = normaldist .+ (Point2f(1, 0),)
+    ax, pl = datashader(fig[2, :], Dict("a" => ds1, "b" => ds2))
+    hidedecorations!(ax)
+    axislegend(ax)
+    fig
+end
diff --git a/docs/reference/plots/datashader.md b/docs/reference/plots/datashader.md
index 04b4a8b7495..f8bde5f5414 100644
--- a/docs/reference/plots/datashader.md
+++ b/docs/reference/plots/datashader.md
@@ -11,7 +11,7 @@
 using DelimitedFiles, GLMakie
 GLMakie.activate!() # hide
 # For saving/showing/inlining into documentation we need to disable async calculation.
-Makie.set_theme!(DataShader = (; async_latest=false))
+Makie.set_theme!(DataShader = (; async=false))
 airports = Point2f.(eachrow(readdlm(assetpath("airportlocations.csv"))))
 fig, ax, ds = datashader(airports,
     colormap=[:white, :black],
diff --git a/src/basic_recipes/datashader.jl b/src/basic_recipes/datashader.jl
index 71add9cfcad..3416e36372d 100644
--- a/src/basic_recipes/datashader.jl
+++ b/src/basic_recipes/datashader.jl
@@ -273,6 +273,7 @@ end
 
 !!! warning
     This feature might change outside breaking releases, since the API is not yet finalized.
+    Please be vary of bugs in the implementation and open issues if you encounter odd behaviour.
 
 Points can be any array type supporting iteration & getindex, including memory mapped arrays.
 If you have separate arrays for x and y coordinates and want to avoid conversion and copy, consider using: