Ordnary

Docs Ordnary Web Services Ordnary Halyard

What Ordnary Halyard is

Feature flags and remote config: turn features on per environment, target users with rules and roll out to a percentage, without a deploy.

4 min readBeginner

Concepts

Project
One app or service. A project has three environments: Production, Staging and Development.
Environment
Each environment has its own state for every flag and its own SDK key, so a flag can be on in Development and off in Production.
Flag
A key such as new-checkout that your code asks for. A flag is a boolean, or a string, number or JSON value for remote config, with two or more variations.
Context
What your app sends about who is asking: a stable key (a user id) plus any attributes your rules use, such as email, country or plan.
SDK key
A key starting with ofk_, one per environment. It can only read that environment's flags, so it is safe in a browser or mobile app.

How a flag is evaluated

  • If the flag is off in the environment, everyone gets its off variation.
  • Otherwise its targeting rules are checked from top to bottom. The first rule whose conditions all match decides what the context gets.
  • If no rule matches, the context gets the default: one variation, or a percentage rollout.

Targeting rules

A condition compares one attribute of the context with one or more values. A rule matches when all its conditions do. For an attribute that is a list (such as roles), a condition matches when any item does.

is one of / is not one of
Exact match against the values. A context without the attribute counts as not one of them.
contains, starts with, ends with
Text matches, ignoring case. email ends with @yourcompany.com targets your own team.
is greater than / is less than
Numeric comparison, for attributes such as age or seats.

Percentage rollouts

A rollout splits contexts over variations by weight, for example 10% on and 90% off. Each context is placed by its key, so a user keeps the same answer every time and stays in as you raise the percentage. Send the same key for the same user on every device.

Limits

Projects

Each with Production, Staging and Development.

50per account

Flags

Keys use lowercase letters, digits, ., _ and -.

500per project

Rules

Each with up to 10 conditions of up to 100 values.

50per flag and environment

Variations

Up to 16 KB each.

2 to 20per flag

Add your first flag

Create a project, add a flag and read it from your app in five minutes.

Open the quickstart
Was this page helpful?
Updated 2 November 2026 Suggest an edit

Choose which cookies Ordnary may use. You can change this at any time via Cookie settings at the bottom of every page.