Skip to content

How the Filter Library works

After reading, you know which way an entry should reach an audience and what each badge in the library means.

Many audiences share the same building blocks: everyone who may be contacted, households that gave in the last year, people in one region. When each builder rebuilds these conditions by hand, the definitions drift apart. One audience leaves out people who opted out of email, the next one forgets. The Filter Library keeps these building blocks in one place.

  1. A curator creates an entry. The entry holds conditions on one object, optionally with related objects or a calculation over related records. See Create a library entry.
  2. The curator decides how fixed the entry is. A fixed entry always applies the same values. A configurable entry leaves one or more values for the builder to fill in. See Make an entry configurable.
  3. Builders add the entry to their audiences. In the filter editor, Copy Existing Filter lists the library entries for that object. See Use a library filter.
  4. An administrator can make an entry a default. CAB then adds the entry to every new filter on that object. A locked default can also be applied to the filters that already exist. See Set defaults and enforce filters.
CopyConfigure & copySyncLocked
Who chooses itThe builderThe builderThe builder, or an administrator through a defaultAn administrator
Works forFixed entriesConfigurable entriesFixed entriesFixed entries
Later changes to the entryDo not reach the audienceDo not reach the audienceReach the audienceReach the audience
Builder can edit the conditionsYesYesAfter DetachNo
Use it whenThe entry is a good starting point that each audience adaptsThe definition is shared, but one value differs per audience, such as an amount or a regionEvery audience must follow one shared definition, and a builder may still opt outA rule must apply to every audience without exception, such as contact preferences

The library lives on the CAB Filter Library tab.

Select an object on the left to see its entries. Find object… narrows the object list, and Search library… searches the entries, including their descriptions and parameter labels. The buttons above the list show only one kind of entry: Default, Locked, Chain, Parameterized or Aggregate.

Each entry shows its conditions under Filter logic, the number of matching records under Records, and where it is used under Used in. The list starts with the most used entries. Select the arrow in front of an entry to see all of its conditions.

BadgeWhat it means
Default · CopyCAB copies the entry into every new filter on this object.
Default · SyncCAB adds the entry to every new filter on this object as a live reference.
Default · LockedCAB enforces the entry on the filters of this object. Builders cannot remove it.
ChainThe entry also filters related objects.
AggregateThe entry calculates over related records.
Parameterized · NThe entry has N parameters that the builder fills in.
Copy-onlyThe entry can only be copied. Configurable entries are always copy-only.

An entry without a Default badge is optional: CAB never adds it by itself. The default only decides what CAB adds automatically. When a builder adds a fixed entry by hand, they still choose between Copy and Sync.

A configurable entry shows no record count and no usage, because both depend on the values a builder fills in.

To create and edit entries, a user needs the Campaign Audience Builder Filter Library Management permission set. Builders who only add entries to their audiences don’t need it. See Permission sets.

  • Library entry. A saved filter in the Filter Library. Example: “Exclude do-not-contact” keeps only Contacts who did not opt out of email and calls.
  • Chain. An entry that also filters related objects. Example: “Active households” keeps Accounts with a paid Gift Transaction in the last 12 months.
  • Aggregate entry. An entry that calculates over related records, such as the sum, count or maximum of a field.
  • Configurable entry. An entry with one or more parameters.
  • Parameter. A value that the builder fills in when they add the entry, for example “Minimum total”. Everything else stays as the curator saved it.
  • Copy. The entry’s conditions are copied into the audience. Later changes to the entry don’t reach the audience.
  • Sync. The audience keeps a live reference to the entry until a builder detaches it.
  • Locked. An administrator enforces the entry. Builders can see it but can’t edit or detach it.
  • Default. An entry that CAB adds by itself to every new filter on its object, as Copy, Sync or Locked.