---
title: TimeSeries
type: tags
order: 310
meta_title: Time Series Tags for Time Series Data

meta_description: Customize Label Studio with the TimeSeries tag to annotate time series data for machine learning and data science projects.

The TimeSeries tag can be used to label time series data. Read more about Time Series Labeling on the time series template page.

Note: The time axis in your data must be sorted, otherwise the TimeSeries tag does not work.
To use autogenerated indices as time axes, don't use the timeColumn parameter.

Use with the following data types: time series.

{% insertmd includes/tags/timeseries.md %}

Channel

Channel tag can be used to label time series data

{% insertmd includes/tags/channel.md %}

Example

Labeling configuration for time series data stored in a CSV loaded from a URL containing 3 columns: time, sensor1, and sensor2. The time column stores time as a number.

<View>
  <TimeSeries name="device" value="$timeseries" valueType="url" timeColumn="time">
     <Channel column="sensor1" />
     <Channel column="sensor2" />
  </TimeSeries>
  <TimeSeriesLabels name="label" toName="device">
    <Label value="Run" background="#5b5"/>
    <Label value="Walk" background="#55f"/>
  </TimeSeriesLabels>
</View>

Example

Labeling configuration for time series data stored in the task field ts in Label Studio JSON format. The time field is stored as a date in the timeformat field and formatted as a full date on the plot (by default).

<View>
  <TimeSeries name="device" value="$ts" timeColumn="time" timeFormat="%m/%d/%Y %H:%M:%S">
     <Channel column="sensor1" />
     <Channel column="sensor2" />
  </TimeSeries>
</View>

MultiChannel

The MultiChannel tag is used to group multiple channels together in a time series visualization. Use this tag within a TimeSeries tag to organize and display multiple data channels in a single view.

{% insertmd includes/tags/multichannel.md %}

Example

Labeling configuration for time series data with multiple channels grouped together:

<View>
  <TimeSeries name="ts" value="$timeseries" 
			  valuetype="url"
              timeColumn="time"
              timeFormat="%Y-%m-%d %H:%M:%S.%f"
              >
    
	<MultiChannel>
      <Channel column="velocity" />
      <Channel column="acceleration" />
    </MultiChannel>

  </TimeSeries>

  <TimeSeriesLabels name="label" toName="ts">
    <Label value="Run" background="red"/>
    <Label value="Walk" background="green"/>
  </TimeSeriesLabels>
</View>

<!-- {
  "timeseries": "https://app.heartex.ai/samples/time-series.csv?time=time&values=velocity%2Cacceleration&tf=%25Y-%25m-%25d+%25H%3A%25M%3A%25S.%25f&type=csv"
} -->