> ## Documentation Index
> Fetch the complete documentation index at: https://docs.replit.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Custom Instructions

> Set workspace-wide guidance that helps Replit follow your team's conventions across Projects and sessions.

export const CustomInstructionsCover = () => <FrostedCover label="A persistent guidance document informing a Replit workspace">
    <div style={{
  position: "absolute",
  width: "clamp(158px, 30vw, 252px)",
  height: "clamp(152px, 26vw, 208px)",
  transform: "translate(16%, -2%) rotate(5deg)",
  border: "1px solid rgba(255,255,255,.3)",
  borderRadius: 20,
  background: "rgba(255,255,255,.11)"
}} />
    <div style={{
  position: "relative",
  width: "clamp(190px, 38vw, 322px)",
  minWidth: "min(62%, 280px)",
  minHeight: "clamp(158px, 27vw, 220px)",
  padding: "clamp(14px, 2.4vw, 22px)",
  border: "1px solid rgba(255,255,255,.66)",
  borderRadius: 21,
  background: "linear-gradient(145deg, rgba(255,255,255,.42), rgba(255,255,255,.12))",
  boxShadow: "0 22px 42px rgba(63,20,6,.24)",
  backdropFilter: "blur(8px)",
  boxSizing: "border-box"
}}>
      <div style={{
  display: "flex",
  alignItems: "center",
  justifyContent: "space-between"
}}>
        <div style={{
  display: "flex",
  gap: 6
}}>
          {[0, 1, 2].map(dot => <span key={dot} style={{
  width: 7,
  height: 7,
  borderRadius: 999,
  background: dot === 0 ? "rgba(255,255,255,.9)" : "rgba(255,255,255,.36)"
}} />)}
        </div>
        <span style={{
  width: 28,
  height: 16,
  padding: 2,
  border: "1px solid rgba(255,255,255,.55)",
  borderRadius: 999,
  background: "rgba(255,255,255,.16)",
  boxSizing: "border-box"
}}>
          <span style={{
  display: "block",
  width: 10,
  height: 10,
  marginLeft: 11,
  borderRadius: 999,
  background: "rgba(255,255,255,.86)"
}} />
        </span>
      </div>
      <div style={{
  marginTop: "clamp(22px, 4vw, 34px)"
}}>
        <Lines widths={["68%", "92%", "78%", "54%"]} strong={0} />
      </div>
      <div style={{
  position: "absolute",
  left: "clamp(14px, 2.4vw, 22px)",
  right: "clamp(14px, 2.4vw, 22px)",
  bottom: "clamp(13px, 2.2vw, 19px)",
  height: 24,
  border: "1px solid rgba(255,255,255,.45)",
  borderRadius: 8,
  background: "rgba(255,255,255,.1)"
}} />
    </div>
  </FrostedCover>;

<CustomInstructionsCover />

Custom Instructions are always-on guidance that you or your team write once for a Workspace. Replit uses them across that Workspace's Projects and sessions, so you do not need to repeat conventions in every Conversation.

Use Custom Instructions for a small set of guidelines that are always true, such as approved libraries, security requirements, or data-handling policies. Keep them short and specific so they leave room for the work at hand.

## Choose the right kind of guidance

* Use **Custom Instructions** for workspace-wide guidance that should always apply.
* Use [Skills](/chat/agent-skills) for reusable approaches and supporting material that are relevant only to particular tasks.
* Use [Memories](/chat/memories) for useful context Replit retains from past work.

## Set up Custom Instructions

Manage Custom Instructions in **Workspace Settings → Customization**. The detailed feature guide covers setup, availability, permissions, and how to keep instructions effective.

<section className="chat-mkt chat-workflow-grid has-visuals">
  <a className="chat-example has-visual" href="/features/agent/agent-customization">
    <div className="chat-use-case-visual palette-ink">
      <div className="chat-use-case-window">
        <i />

        <i />

        <i />

        <b />

        <b />

        <b />
      </div>

      <em>
        <Icon icon="sliders" size={24} />
      </em>
    </div>

    <span>
      <Icon icon="sliders" size={19} />
    </span>

    <div className="chat-card-title">Custom Instructions reference</div>
    <p>Set up workspace-wide guidance and learn when it applies.</p>
    <div className="chat-card-link">Open the feature guide →</div>
  </a>
</section>