Feature metadata

Metadata consists of additional descriptive information about your features - such as descriptions, ownership details, and positioning - that helps organize and manage them effectively.

Description

Every feature can have a descriptive text that explains its purpose and usage. You can set or update this description when creating the feature or later using the ALTER command.

Example

ALTER FEATURE customer_lifetime_value
SET DESCRIPTION = 'Calculates the total value of a customer based on their historical purchases';
sql

@fql-playground(alter_show)

Point of Contact

Each feature requires designated contacts for maintenance and incident response:

  1. Point of Contact: The main maintainer and domain expert (point_of_contact)
  2. Pager Duty Contact: The on-call contact for alerts (pager_duty)

Setting Contact Information

ALTER FEATURE customer_lifetime_value
SET point_of_contact = 'team1@company.com',
    pager_duty = 'team1_oncall@company.com';
sql

Important Notes

  • Point of contact is initialised with the name of the creator of the feature
  • Pager duty is required for features with BETA status or higher
  • Being the POC doesn't grant special permissions on the feature

Position in namespace

Features can be organized within their namespace by setting their position relative to other features. This affects how features are displayed and ordered in the UI and documentation.

Position Options

You can set a feature's position using the following syntax:

ALTER FEATURE feature_name SET POSITION <position_type>
sql

Where position_type can be:

  • HIDE: Remove from default view
  • FIRST: Place at the beginning
  • LAST: Place at the end
  • BEFORE feature_name: Position right before specified feature
  • AFTER feature_name: Position right after specified feature
  • INTEGER_VALUE: Set absolute position

Example

Current position:

Modify position:

Updated position:

Suggest changes to this page
Last update at: 2025/11/06 07:00:15
Last updated: 2025-11-06 07:00:51