---
title: "Update Performance Settings Ability: Change a Performance Feature State in WordPress"
url: https://nexterwp.com/docs/nexter-update-performance-settings/
date: 2026-05-29
modified: 2026-05-29
author: "sandip patel"
description: "The nexter/update-performance-settings ability updates a single Nexter Extension performance feature at a time, setting its enabled state and optional configuration values."
word_count: 236
---

# Update Performance Settings Ability: Change a Performance Feature State in WordPress

## Key Takeaways

- The nexter/update-performance-settings ability updates a single Nexter Extension performance feature per call.
- The values object is optional and omitting it leaves existing values unchanged during updates.
- Nexter Extension (Free) must be installed to use the nexter/update-performance-settings ability for performance feature management.

The **nexter/update-performance-settings** ability updates a single Nexter Extension performance feature per call. Pass the feature name, its enabled state, and optional configuration values. To update multiple features, call this ability once per feature. Use nexter/get-performance-settings to read current values before making changes.

## Key Takeaways

The feature parameter is required. It must match an exact feature identifier from the performance settings.

This ability updates one feature per call. Run it multiple times to update multiple features.

The values object is optional and contains feature-specific settings. Omitting it leaves existing values unchanged.

Use nexter/get-performance-settings first to see valid feature names and current values.

## Required Setup

This ability ships with Nexter Extension (Free). If you do not have it installed, follow the guide on how to install and activate Nexter Extension first.

## Parameters

**feature** (string, required) is the identifier of the performance feature to update. Use nexter/get-performance-settings to list valid identifiers.

**enabled** (boolean, optional) sets whether the feature is active.

**values** (object, optional) contains feature-specific configuration keys. The required keys vary by feature.

## What It Returns

The ability returns **success** (boolean) and the updated feature object containing its new **enabled** state and **values**.

## When to Use This Ability

Enable lazy loading or disable emojis as part of a site performance setup workflow.

Configure heartbeat control intervals to reduce server load on high-traffic sites.

Automate performance feature configuration when provisioning new WordPress sites.

## Related Documentation

Get Performance Settings Ability: nexter/get-performance-settings

Update Security Settings Ability: nexter/update-security-settings

List Extensions Ability: nexter/list-extensions