diff --git a/Migration.md b/Migration.md
index 8baf4ab1d7..012dbafdb8 100644
--- a/Migration.md
+++ b/Migration.md
@@ -36,6 +36,9 @@ Gazebo 2+ for playback. [BitBucket pull request
 #257](https://osrf-migration.github.io/ignition-gh-pages/#!/ignitionrobotics/ign-gazebo/pull-requests/257)
 added an SDF message to the start of log files.
 
+* Log playback using `<path>` SDF parameter is deprecated. Use `--playback`
+  command line argument instead.
+
 ## Ignition Gazebo 1.0.2 to 1.1.0
 
 * All headers in `gazebo/network` are no longer installed.
diff --git a/examples/worlds/log_playback.sdf b/examples/worlds/log_playback.sdf
index f924f1208e..7017ba53d1 100644
--- a/examples/worlds/log_playback.sdf
+++ b/examples/worlds/log_playback.sdf
@@ -2,6 +2,9 @@
 <!--
   Log playback demo.
 
+  This file will be removed in Ignition Dome. Use the command line argument
+  for playback instead.
+
   Running this world will playback log files located at /tmp/log.
 
   You can record such a log by running one of the `log_record*.sdf` files,
@@ -15,6 +18,8 @@
     <plugin
       filename='ignition-gazebo-log-system'
       name='ignition::gazebo::systems::LogPlayback'>
+      <!-- Deprecation warning: This parameter will be removed in Ignition Dome.
+           Use the command line argument for playback instead. -->
       <path>/tmp/log</path>
     </plugin>
   </world>
diff --git a/tutorials/log.md b/tutorials/log.md
index 6846d1cdf4..a401a32263 100644
--- a/tutorials/log.md
+++ b/tutorials/log.md
@@ -114,6 +114,9 @@ directory specified to record:
 
 ### From plugin in SDF
 
+This feature is deprecated and will be removed in Ignition Dome.
+Use the command line argument instead.
+
 Alternatively, playback can be specified in an SDF file. See example file
 `examples/worlds/log_playback.sdf`: