---
updatedAt: 2026-07-27T09:56:15.000Z
agentTools:
  projectIndex: https://docs.damoov.com/llms.txt
---

# Period (Future) Tag for iOS app

You can add, remove, and get a list of installed tags on IncomingTags for enriched trips these are the same tags as on Incoming but already linked to a specific track. You can also delete, add, and.

<Callout icon="⚠️" theme="warning">
  ###

  Period (Future) Tags are deprecated and will be removed in a future release. Use Properties for trip metadata instead. For more information, see [Methods for iOS app](https://docs.damoov.com/docs/methods-for-ios-app).
</Callout>

You can add, remove, and get a list of installed tags on IncomingTags for enriched trips these are the same tags as on Incoming but already linked to a specific track. You can also delete, add, and get Tags already linked to a specific track.

## Manage Tag methods

### Add a new tag

```swift
let tagExample = RPFutureTag(
    tag: "ExampleTag",
     source: "ExampleTagSource"
)
        
RPEntry.instance.api.addFutureTrackTag(tagExample) { status, error in
    if let error {
        print(error.localizedDescription)
        return
    }
            
    print(status.rawValue)
}
```
```objectivec
RPFutureTag *tagExample = [[RPFutureTag alloc] initWithTag:@"ExampleTag"
                                                    source:@"ExampleTagSource"];
    
[[RPEntry instance].api addFutureTrackTag:tagExample completion:^(enum RPTagStatus status, NSError * _Nullable error) {
    if (error) {
        NSLog(@"%@", error.localizedDescription);
        return;
    }
    NSLog(@"%ld", (long)status);
}];
```

### Remove tag

```swift
let tagExample = RPFutureTag(
    tag: "ExampleTag",
     source: "ExampleTagSource"
)
        
RPEntry.instance.api.removeFutureTrackTag(tagExample) { status, error in
    if let error {
        print(error.localizedDescription)
        return
    }
            
    print(status.rawValue)
}
```
```objectivec
RPFutureTag *tagExample = [[RPFutureTag alloc] initWithTag:@"ExampleTag"
                                                    source:@"ExampleTagSource"];
    
[[RPEntry instance].api removeFutureTrackTag:tagExample completion:^(enum RPTagStatus status, NSError * _Nullable error) {
    if (error) {
        NSLog(@"%@", error.localizedDescription);
        return;
    }
    NSLog(@"%ld", (long)status);
}];
```

### Get tags

```swift
let dateExample = Date()
RPEntry.instance.api.getFutureTrackTag(dateExample) { status, tags in
    print(status.rawValue)
    print(tags)
}
```
```objectivec
NSDate *dateExample = [NSDate date];
[[RPEntry instance].api getFutureTrackTag:dateExample
                               completion:^(enum RPTagStatus status, NSArray<RPFutureTag *> * _Nonnull tags) {
    NSLog(@"%ld", (long)status);
    NSLog(@"%@", tags);
}];
```

### Remove all tags

```swift
RPEntry.instance.api.removeAllFutureTrackTags { status, error in
    if let error {
        print(error)
        return
    }
    print(status.rawValue)
}
```
```objectivec
[[RPEntry instance].api removeAllFutureTrackTagsWithCompletion:^(enum RPTagStatus status, NSError * _Nullable error) {
    if (error) {
        NSLog(@"%@", error.localizedDescription);
        return;
    }
    NSLog(@"%ld", (long)status);
}];
```

***