Version: 2018.4
  • C#


struct in UnityEngine


Implemented in:UnityEngine.ParticleSystemModule

Suggest a change


Thank you for helping us improve the quality of Unity Documentation. Although we cannot accept all submissions, we do read each suggested change from our users and will make updates where applicable.


Submission failed

For some reason your suggested change could not be submitted. Please <a>try again</a> in a few minutes. And thank you for taking the time to help us improve the quality of Unity Documentation.



Switch to Manual


Access the particle system trails module.

using UnityEngine;
using System.Collections;

public class ExampleClass : MonoBehaviour { void Start() { ParticleSystem ps = GetComponent<ParticleSystem>(); var trails = ps.trails; trails.enabled = true; trails.ratio = 0.5f; } }


attachRibbonsToTransformAdds an extra position to each ribbon, connecting it to the location of the Transform Component.
colorOverLifetimeThe gradient controlling the trail colors during the lifetime of the attached particle.
colorOverTrailThe gradient controlling the trail colors over the length of the trail.
dieWithParticlesIf enabled, Trails will disappear immediately when their owning particle dies. Otherwise, the trail will persist until all its points have naturally expired, based on its lifetime.
enabledEnable/disable the Trail module.
generateLightingDataConfigures the trails to generate Normals and Tangents. With this data, Scene lighting can affect the trails via Normal Maps and the Unity Standard Shader, or your own custom-built Shaders.
inheritParticleColorToggle whether the trail will inherit the particle color as its starting color.
lifetimeThe curve describing the trail lifetime, throughout the lifetime of the particle.
lifetimeMultiplierChange the lifetime multiplier.
minVertexDistanceSet the minimum distance each trail can travel before a new vertex is added to it.
modeChoose how particle trails are generated.
ratioChoose what proportion of particles will receive a trail.
ribbonCountSelect how many lines to create through the Particle System.
shadowBiasApply a shadow bias to prevent self-shadowing artifacts. The specified value is the proportion of the trail width at each segment.
sizeAffectsLifetimeSet whether the particle size will act as a multiplier on top of the trail lifetime.
sizeAffectsWidthSet whether the particle size will act as a multiplier on top of the trail width.
splitSubEmitterRibbonsWhen used on a sub emitter, ribbons will connect particles from each parent particle independently.
textureModeChoose whether the U coordinate of the trail texture is tiled or stretched.
widthOverTrailThe curve describing the width, of each trail point.
widthOverTrailMultiplierChange the width multiplier.
worldSpaceDrop new trail points in world space, regardless of Particle System Simulation Space.